intro on address allocation

source/about/introduction.rst

@@ -10,15 +10,14 @@ This page gives a broad overview of the RPKI and how it can help make Internet r
 About this documentation
 ++++++++++++++++++++++++
 
-This documentation is continuously written, corrected and edited by the RPKI team at NLnet Labs. An initial version was written by Alex Band, Tim Bruijnzeels and Martin Hoffmann. Over time, many additions from the network operators community, researchers and interested parties around the world were contributed. It is edited via text files in the
-`reStructuredText <http://www.sphinx-doc.org/en/stable/rest.html>`_ markup
+This documentation is continuously written, corrected and edited by the RPKI team at NLnet Labs. An initial version was written by Alex Band, Tim Bruijnzeels and Martin Hoffmann. Over time, many additions from the network operators community, researchers and interested parties around the world were contributed. The documentation is edited via text files in the `reStructuredText <http://www.sphinx-doc.org/en/stable/rest.html>`_ markup
 language and then compiled into a static website/offline document using the
 open source `Sphinx <http://www.sphinx-doc.org>`_  and `ReadTheDocs
 <https://readthedocs.org/>`_ tools.
 
-.. note:: You can contribute to the RPKI documentation by opening issue tickets
-          or sending patches via pull requests on its GitHub
-          `source repository <https://github.com/NLnetLabs/rpki-doc>`_.
+.. note:: You can contribute to the RPKI documentation by opening an issue
+          or sending patches via pull requests on the `GitHub
+          source repository <https://github.com/NLnetLabs/rpki-doc>`_.
 
 All the contents are under the permissive Creative Commons Attribution 3.0
 (`CC-BY 3.0 <https://creativecommons.org/licenses/by/3.0/>`_) license, with

source/index.rst

@@ -11,11 +11,11 @@ Welcome to the documentation of the Resource Public Key Infrastructure (RPKI), t
 The table of contents below and in the sidebar should let you easily access the documentation for your topic of interest. You can also use the search function in the top left corner.
 
 .. note:: This documentation is an open source project maintained by the RPKI team at 
-          NLnet Labs, as well as the network operator community around the world. It 
-          means we always appreciate your feedback and improvements.
+          NLnet Labs, with contributions from  the network operator community around 
+          the world. We always appreciate your feedback and improvements.
 
-          Submit an issue or pull request on the `GitHub repository
-          <https://github.com/NLnetLabs/rpkidoc/issues>`_, or send us a message on the
+          You can submit an issue or pull request on the `GitHub repository
+          <https://github.com/NLnetLabs/rpkidoc/issues>`_, or post a message on the
           `RPKI mailing list <https://nlnetlabs.nl/mailman/listinfo/rpki>`_. 
 
 The main documentation is organised into the following sections: