docs: improve formatting and document structure
Change-Id: I4b0b4cc3eae000aa1c988c5d308c3f78052ad96d
diff --git a/docs/index.rst b/docs/index.rst
index ea4ae0a..b7aa61f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,5 +1,14 @@
-PSync - Partial/Full Sync Library based on BF and IBF
-=====================================================
+PSync: Partial/Full Sync Library based on BF and IBF
+====================================================
+
+.. toctree::
+ :hidden:
+ :maxdepth: 2
+
+ install
+ examples
+ release-notes
+ releases
PSync is a C++ library for name synchronization that implements the `PSync protocol
<https://named-data.net/wp-content/uploads/2017/05/scalable_name-based_data_synchronization.pdf>`__.
@@ -11,31 +20,22 @@
PSync uses the `ndn-cxx <https://github.com/named-data/ndn-cxx>`__ library.
+Documentation
+-------------
+
+- :doc:`install`
+- :doc:`examples`
+- :doc:`release-notes`
+- :doc:`releases`
+
Contributing
------------
We greatly appreciate contributions to the PSync code base, provided that they are
-licensed under the LGPL 3.0+ or a compatible license (see `COPYING.md
+licensed under the GNU LGPL version 3 or a compatible license (see `COPYING.md
<https://github.com/named-data/PSync/blob/master/COPYING.md>`__ for more information).
-If you are new to the NDN software community, please read the `Contributor's Guide
+If you are new to the NDN software community, please read our `Contributor's Guide
<https://github.com/named-data/.github/blob/master/CONTRIBUTING.md>`__ to get started.
Please submit any bug reports or feature requests to the `PSync issue tracker
<https://redmine.named-data.net/projects/psync/issues>`__.
-
-PSync Documentation
--------------------
-
-.. toctree::
- :hidden:
- :maxdepth: 2
-
- install
- examples
- release-notes
- releases
-
-- :doc:`install`
-- :doc:`examples`
-- :doc:`release-notes`
-- :doc:`releases`