.. Documentation tutorial documentation master file, created by
   sphinx-quickstart on Thu Mar 22 19:57:59 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. _tuto_doc:

==========================
Documentation tutorial
==========================

.. sidebar:: Documentation tutorial

    :Release: |release|
    :Date: |today|
    :Authors: **Devops people**
    :Target: Tutorial about documentation

.. seealso::

   - https://gitlab.com/gdevops
   - https://gitlab.com/gdevops/tuto_documentation
   - https://gdevops.gitlab.io/tuto_devops/
   - http://blog.smartbear.com/software-quality/bid/256072/13-reasons-your-open-source-docs-make-people-want-to-scream
   - http://brikis98.blogspot.de/2014/05/you-are-what-you-document.html
   - http://redaction-technique.org/index.html


Our favorite document generator is :ref:`sphinx <sphinx>` and we use the
:ref:`reStructuredText markup <rest_sphinx>`.


.. toctree::
   :maxdepth: 3

   news/news
   advices/advices
   doc_generators/doc_generators
   hebergeurs/hebergeurs
   good_documentation/good_documentation
   formats/formats
   projects/projects
   tools/tools
   videos/videos
   wiki/wiki