Updates based upon recent requests by operators and FBIS.

README.md

-ESS Reference & Lookup Tables
---
+# ESS Reference & Lookup Tables
 
-# Directory description
+----
 
-* init: will be loaded during the initialization. The facility constant configuration.
-* supercycles: will be loaded upon the selection (memorized PV with the supercycle table selection). The dynamic routines/cycles (runtime).
-* tools: productivity enhancements.
-* doc: other documents and references.
+- [ Project Directory Structure ](#Directory)
+- [ Tag Versioning ](#Tag)
 
-# Supercycle manual
-* https://confluence.esss.lu.se/display/HAR/Supecycle
+----
 
-# References
-* Description of Modes for ESS Accelerator Operation: ESS-0038258
-  * $(ESS-0038258->Revision) == $ProtVer
-* Beam Configuration: https://confluence.esss.lu.se/display/ABC/Beam+Configuration
-* Master events according to: ESS-1837307: Time Structure of the Proton Beam Pulses in the LINAC.
+## Project Directory Structure
+<a name="Directory"></a>
 
-# Tag versioning
-* MAJOR = {ProtNum}
-* MINOR = {ESS-0038258 revision, ProtVer}
-* PATH = {supercycle adds, bug corrections}
+### [init](init)
 
-e.g. 1.5.0 contains ProtNum == 1, ESS-0038258 revision == 5 and ProtVer == 5 and it is compatible with all 1.5.x.
\ No newline at end of file
+It loads during the initialization and contains ESS constant variables and enumerations for:
+- [databuffer-ess](init/databuffer-ess.json) proton beam modes, destination and state according to ESS-0038258 (_Description of Modes for ESS Accelerator Operation_)
+
+- [mevts-ess](init/mevts-ess.json) - master events according to: ESS-1837307 (_Time Structure of the Proton Beam Pulses in the LINAC_).
+
+See [Beam Configuration](https://confluence.esss.lu.se/display/ABC/Beam+Configuration) for additional details.
+
+### [supercycles](supercycles)
+
+It loads upon the selection by an ESS operator (see the [manual](https://confluence.esss.lu.se/display/HAR/Supecycle)). The dynamic routines/cycles (runtime).
+
+### [tools](tools)
+
+Productivity enhancements.
+
+### [doc](doc)
+
+Other documents, manuals, references and drafts.
+
+## Tag Versioning
+<a name="Tag"></a>
+
+- MAJOR (1st digit) == {Backward compatibility mark}
+- MINOR (2sd digit) == {ESS-0038258 Chess Revision, ProtNum}
+- PATH (3rd digit) == {ESS-1837307 Chess Revision, ProtVer}
+- BUILD (4th digit) == {supercycle adds, bug corrections}
+
+e.g. 1.5.1+1 means:
+- all with 1 is compatible,
+- ProtNum == 5, ESS-0038258 revision == 5,
+- ProtVer == 1, ESS-1837307 revistion == 1,
+- +1 - some files were introduced, e.g. supercycle tables.

doc/README.md

+## Complementary Documentation
+
+* [Timing Data Model Specification](https://confluence.esss.lu.se/display/HAR/Timing+Data+Model+Specification)
\ No newline at end of file

init/README.md

-Init
---
-
-# databuffer-ess.json
-* The databuffer enumeration
-
-# accelerator-operation-ess.json
-* The accelerator operation enumeration (not included into the databuffer)
-
-# mevts-ess.json
-* Master events according to: ESS-1837307: Time Structure of the Proton Beam Pulses in the LINAC.

init/databuffer-ess.json

 {
-  "ProtNum": 1,
-  "ProtVer": 5,
-  "doc": "ESS-0038258",
+  "ProtNum": 5,
+  "ProtVer": 1,
   "PBState": {
     "None": {
       "id": 0,