From 8effeaa5ae13c8b7a21542edab146cb2c696c53f Mon Sep 17 00:00:00 2001
From: Jan Kaluza <jkaluza@redhat.com>
Date: Apr 22 2020 06:52:12 +0000
Subject: Add initial Fedora ELN compose documentation.


---

diff --git a/modules/ROOT/pages/compose.adoc b/modules/ROOT/pages/compose.adoc
index e69de29..8aa8bec 100644
--- a/modules/ROOT/pages/compose.adoc
+++ b/modules/ROOT/pages/compose.adoc
@@ -0,0 +1,61 @@
+= Fedora ELN compose =
+
+== Summary ==
+
+The Fedora ELN compose is built using the ODCS (On Demand Compose Service). There are two ODCS
+instances (production and staging) and therefore two places with the latest ELN composes:
+
+|===
+|Description | Environment | Link
+
+|Latest Fedora-ELN compose | production | Not available yet
+|Latest Fedora-ELN compose | staging | https://odcs.stg.fedoraproject.org/composes/test/latest-Fedora-ELN/
+
+|===
+
+
+== Compose configuration files ==
+
+The main Fedora ELN compose configuration file is stored in the official https://pagure.io/pungi-fedora/
+repository in the ``eln`` branch.
+
+The Fedora ELN compose uses the Rawhide comps file stored in the https://pagure.io/fedora-comps repository
+and also the Rawhide module-defaults stored in thehttps://pagure.io/releng/fedora-module-defaults/ 
+repository.
+
+
+== Generating the Fedora ELN compose ==
+
+Members of the https://admin.fedoraproject.org/accounts/group/view/eln-sig[eln-sig] FAS group
+(and https://admin.stg.fedoraproject.org/accounts/group/view/eln-sig[eln-sig] FAS staging group) can
+generate Fedora ELN compose using the ``odcs`` command line client.
+
+The ODCS command client is availabe in the ``odcs-client`` package:
+
+```
+$ sudo dnf install odcs-client
+```
+
+The Fedora ELN compose can then be generated by the following command on ODCS staging:
+
+```
+$ odcs --staging create-raw-config eln eln
+```
+
+Or on production ODCS (Not available yet):
+
+```
+$ odcs create-raw-config eln eln
+```
+
+Once the compose is generated, the JSON response is printed and the most important attribute is
+the ``toplevel_url`` which points to the directory with generated compose.
+
+[NOTE]
+====
+
+When using ODCS version <= 0.2.39, the older syntax needs to be used to generate Fedora ELN compose:
+
+```
+odcs --staging create raw_config eln#eln
+```