diff --git a/README.md b/README.md
index 7a91634f7a848c6bb08069d937f0208eacabd679..78f800ffbc1e86d6a07905e2079b781a98e90b05 100644
--- a/README.md
+++ b/README.md
@@ -8,3 +8,10 @@ ESS Reference & Lookup Tables
 * tools: productivity enhancements.
 * doc: other documents and references.
 
+# Supercycle manual
+* https://confluence.esss.lu.se/display/HAR/Supecycle
+
+# References
+* Description of Modes for ESS Accelerator Operation: ESS-0038258
+* Beam Configuration: https://confluence.esss.lu.se/display/ABC/Beam+Configuration
+
diff --git a/doc/README.md b/doc/README.md
deleted file mode 100644
index 3ebfdbde26f7f6f59ca59c87e95b10ba9a8ea23d..0000000000000000000000000000000000000000
--- a/doc/README.md
+++ /dev/null
@@ -1,15 +0,0 @@
-Documentation
---
-
-# Data buffer
-
-* https://confluence.esss.lu.se/display/HAR/Data+Buffer
-
-# Beam Configuration
-
-* https://confluence.esss.lu.se/display/ABC/Beam+Configuration
-
-# Chess
-
-## Description of Modes for ESS Accelerator Operation
-* ESS-0038258
diff --git a/init/.gitkeep b/init/.gitkeep
deleted file mode 100644
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000
diff --git a/init/README.md b/init/README.md
deleted file mode 100644
index 48735e6ea739de9a145ca80989acddcf136491dc..0000000000000000000000000000000000000000
--- a/init/README.md
+++ /dev/null
@@ -1,19 +0,0 @@
-init
---
-
-# Usage
-* Load this file upon the startup. The file contains the constant configuration of the machine.
-
-# Note
-* modes->id: will be hardcoded in the firmware by
-  * the machine protection group
-  * PLC group
-* EVT_14HZ is always ON. The cycle fiducial mark and the first event within the sequence.
-
-# Target Segment
-* pv: TgSeg-RB [uint] - the actuall target segment number.
-
-# TODO
-* Event mapping for each mode.
-* 1Hz beam operation means that which events always exist in the 1Hz beam? ION_ST/END?
-* Constant base time shift for each event code.
diff --git a/supercycles/.gitkeep b/supercycles/.gitkeep
deleted file mode 100644
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000
diff --git a/supercycles/README.md b/supercycles/README.md
deleted file mode 100644
index ac49059080fce1c04326b05c79416f0ea1f33ffb..0000000000000000000000000000000000000000
--- a/supercycles/README.md
+++ /dev/null
@@ -1,14 +0,0 @@
-ESS Supercycle Tables
---
-
-# Specification
-* Operating frequency: one linac cycle (14 Hz).
-* Sequential row execution.
-
-# Design Guide
-* Place a supecycle table in this directory.
-* Use "libreoffice" or "Microsoft Excel" to create/edit .csv files (comma-separated values).
-* Each table should have a unique name {name}.csv.
-* Fist "row" defines keys for each dataset within its collumn (key).
-* The keywords are the same as Data Buffer PVs (PBDest, PBMod, ...) and Event Codes (BPULSE_ST, BPULSE_END, ...).
-* Each row requires a unique Id number (the reference purpose).
diff --git a/tools/.gitkeep b/tools/.gitkeep
deleted file mode 100644
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000