[DOCS] improve index to help people getting started

Author: jaapio

docs/about.rst

@@ -0,0 +1,35 @@
+..  include:: /include.rst.txt
+
+============
+About Guides
+============
+
+phpDocumentor's Guides library takes hand-written documentation in code repositories, creates an AST from that and feeds
+it to a renderer to create the desired output.
+
+As part of this goal, the Guides library itself is more of a framework where you can plug in support for an input
+format, such as Restructured Text, and plug in an output format to output towards, such as HTML.
+
+Supported Formats
+=================
+
+Input
+-----
+
+As this is a new component, the number of formats are limited and can expand in the future
+
+-   RestructuredText; Well-supported, though still work in progress
+-   Markdown; Early stages, not working yet
+
+Output
+------
+
+As this is a new component, the number of formats are limited and can expand in the future
+
+-   HTML
+-   LaTeX; Well-supported, though still work in progress
+
+Usage
+=====
+
+See :doc:`usage`.

docs/index.rst

@@ -1,5 +1,7 @@
 ..  include:: /include.rst.txt
 
+:project:
+    Guides
 :version:
     dev-main
 
@@ -16,17 +18,17 @@ Report issues
 Latest public documentation
     |composer_support_docs|
 
-This project contains a framework for rendering documentation. It provides a simple commandline tool to render
-your documentation from `reStructuredText Markup <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html>`__ and
-`Markdown <https://daringfireball.net/projects/markdown/>`__. to HTML or LaTeX. And can be extended to support other
-formats.
+If you are building your own application you can install the libraries using `Composer <https://getcomposer.org/>`__::
 
-Besides the commandline tool it also provides a number of libraries that can be used to build your own application
-to render the supported formats, to any format you want. On these pages is explained how to use the commandline tool
-and how to use the libraries.
+.. code:: bash
 
-If you are looking for a complete solution to create a documentation website then you may want to look at
-`PHPDocumentor <https://phpdoc.org/>`__.
+    composer require phpdocumentor/guides
+
+This will install all basic libraries needed to get started to get started.
+All libraries come with support for `Symfony dependency injection <https://symfony.com/doc/current/components/dependency_injection.html>`__.
+This will help you to get started with the libraries in symfony applications.
+
+Read more about writing your own application in the :doc:`developers` section.
 
 .. tip::
 
@@ -42,10 +44,8 @@ If you are looking for a complete solution to create a documentation website the
 .. toctree::
     :hidden:
 
-    installation
-    cli/index
-    components/index
-    developers/index
-    architecture
-    reference/index
-    contributions/index
+    usage
+    configuration
+    extension/index
+    rst-reference/index
+    about