From 82cbed4157d25c0bc5a61d04f4af421214ec2d12 Mon Sep 17 00:00:00 2001
From: Robert Varga <robert.varga@pantheon.tech>
Date: Wed, 26 Apr 2023 04:09:23 +0200
Subject: [PATCH] Add repostory documentation

To ease navigation for users of GitHub, add README.rst to document where
things are in the repository. This includes a ton of stale links, which
will be filled in by future constributions.

Change-Id: I2d8945911aa91008ce4ca45b25dd8004eb6ed2c7
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
---
 README.rst      | 25 +++++++++++++++++++++++++
 apps/README.rst | 13 +++++++++++++
 docs/index.rst  |  2 +-
 3 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 README.rst
 create mode 100644 apps/README.rst

diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000000..1054851e16
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,25 @@
+============================================
+OpenDaylight NETCONF/RESTCONF implementation
+============================================
+
+This project hosts implementations of protocols defined by the
+`IETF NETCONF Working Group <https://datatracker.ietf.org/wg/netconf/about/>`__
+In particular it implements:
+* `Network Configuration Protocol (NETCONF) <https://www.rfc-editor.org/rfc/rfc6241>`__
+* `RESTCONF Protocol <https://www.rfc-editor.org/rfc/rfc8040>`__
+
+Your immediate interests may be:
+* Documentation is in :doc:`docs <https://docs.opendaylight.org/projects/netconf/en/latest/index.html>`
+* Ready-to-applications are in :doc:`apps <apps/README.rst>`
+
+Other that that, you may delve into gory details:
+* basic project infrastructure, including :doc:`the BOM <artifacts/README.rst>`,
+  :doc:`Karaf features <features/README.rst>`, :doc:`Dynamic Karaf distribution <karaf/README.rst>`,
+  :doc:`Static Karaf distribution <karaf-static/README.rst>` and the :doc:`Common Maven Parent <parent/README.rst>`
+* :doc:`YANG models <models/README.rst>` relating to this project
+* :doc:`Transport layer <transport/README.rst>` implementation
+* :doc:`Low-level <protocol/README.rst>` protocol implementations
+* :doc:`High-level <plugins/README.rst>` protocol integrations
+* :doc:`NETCONF Key store <keystore/README.rst>` implementation
+* :doc:`NETCONF Trust store <truststore/READ.rst>` implementation
+* :doc:`applications <appls/README.rst>` for both end users and integrators
diff --git a/apps/README.rst b/apps/README.rst
new file mode 100644
index 0000000000..23186e2909
--- /dev/null
+++ b/apps/README.rst
@@ -0,0 +1,13 @@
+====================
+NETCONF applications
+====================
+
+This directory hosts the various applications built with NETCONF/RESTCONF
+:doc:`high-level <../plugins/README.rst>` integrations.
+
+This includes:
+* :doc:`NETCONF Events on top of MD-SAL <netconf-events-mdsal/README.rst>`
+* :doc:`CLI client <netconf-console/README.rst>` for NETCONF servers
+* :doc:`NETCONF ietf-topology.yang <netconf-topology/README.rst>` implementations
+  * for :doc:`single-node <netconf-topology-impl/README.rst>` deployments
+  * for :doc:`clustenered <netconf-topology-singleton/README.rst>` deployments
diff --git a/docs/index.rst b/docs/index.rst
index 75bfa0e847..9a6f60fe8b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7 +1,7 @@
 .. _netconf:
 
 ##############################
-NETCONF/RESTCONF documentation
+NETCONF/RESTCONF Documentation
 ##############################
 
 .. toctree::
-- 
2.36.6