.. include:: Includes.txt

.. _start:

=====================
Writing Documentation
=====================

:Authors:   TYPO3 Documentation Team & community (see :ref:`credits`)
:Status:    Fully revised (August, 2019)
:License:   Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (`CC BY-NC-SA 4.0 <https://creativecommons.org/licenses/by-nc-sa/4.0/>`__)

**About this manual:**

   This manual is about writing TYPO3 documentation
   (`docs.typo3.org <https://docs.typo3.org>`__). Find out more in:

   .. rst-class:: horizbuttons-primary-xxl

   * :ref:`how-to-read-this-guide`



**Did you know?**

   - 2019-06-01 :ref:`tip-branches-master`
   - 2019-05-29 :ref:`[IMPORTANT] Migration to New Infrastructure <tip-ext-new-doc-server>` (Extension Authors)
   - 2019-03-17 :ref:`tip-edit-me-on-github` (Extension Authors)
   - 2019-03-13 :ref:`tip-link-to-issues` (Extension Authors)

   :ref:`FAQ for extension authors ... <faq-for-extension-authors>`

.. uncomment this, when there are new general tips
   :ref:`More general Tips ... <Tip-of-the-day>` | :ref:`More tips for extension authors ... <tips-extension-authors>`


**What's new in this guide?**

   - 2019-09-13 :ref:`howto-update-docs`
   - 2019-05-29 :ref:`news-2019-new-doc-server`
   - 2019-02-03 :ref:`news-2019-rest-cheat-sheet`

   More: :ref:`What's new in this guide ... <whats-new>`


.. toctree::
   :hidden:
   :caption: BASICS

   About
   HowToGetHelp
   BasicPrinciples
   GeneralConventions/Index
   WritingReST/Index

.. toctree::
   :hidden:
   :caption: HOWTOS

   WritingContent/Index
   WritingDocForExtension/Index
   WritingDocsOfficial/Index
   ToolsEditRest/Index
   RenderingDocs/Index
   GitHub/Index
   HowToAddTranslation/Index


.. toctree::
   :hidden:
   :caption: ADVANCED

   T3DocTeam @ Work  ➜  <https://docs.typo3.org/typo3cms/Teams/T3DocTeam/>

.. toctree::
   :hidden:
   :caption: OTHER

   Appendix/Index
   UsefulLinks
   Sitemap/Index