..
   Simply reuse the root readme

.. include:: ../../README.rst

.. card:: Getting started

    .. grid:: 2
    
        .. grid-item-card:: :octicon:`list-unordered` What is PyAnsys?
           :link: getting-started/index
           :link-type: doc
    
           An introduction to the PyAnsys project and its ecosystem.

        .. grid-item-card:: :octicon:`law` Project approval and release
           :link: getting-started/administration
           :link-type: doc

           Steps to authorize the public release of a PyAnsys library.


.. card:: Explanations

    .. grid:: 2
    
        .. grid-item-card:: :octicon:`list-unordered` How-to
           :link: how-to/index
           :link-type: doc
    
           Step-by-step guidelines.

        .. grid-item-card:: :octicon:`repo` Abstractions
           :link: abstractions/index
           :link-type: doc

           Explanations of the PyAnsys architecture.


.. card:: Style guidelines

    .. grid:: 3
    
        .. grid-item-card:: :octicon:`file-directory` Packaging style
           :link: packaging/index
           :link-type: doc
    
           Best practices for distributing Python code.
    
        .. grid-item-card:: :octicon:`codespaces` Coding style
           :link: coding-style/index
           :link-type: doc
    
           Best practices for writing Python code.
    
        .. grid-item-card:: :octicon:`pencil` Documentation style
           :link: doc-style/index
           :link-type: doc
    
           Best practices for writing documentation.

.. toctree::
   :hidden:
   :maxdepth: 3

   getting-started/index
   how-to/index
   all-styles
   abstractions/index
   content-writing/index