diff --git a/Documentation/Index.rst b/Documentation/Index.rst
index 1b0ea231..ea783800 100644
--- a/Documentation/Index.rst
+++ b/Documentation/Index.rst
@@ -7,129 +7,120 @@ Writing documentation
=====================
:Version:
- |release|
+ |release|
:Language:
- en
+ en
:Author:
- TYPO3 contributors
+ TYPO3 contributors
:License:
- This document is published under the
- `Creative Commons BY 4.0 `__
- license.
+ This document is published under the
+ `Creative Commons BY 4.0 `__
+ license.
:Rendered:
- |today|
+ |today|
----
This guide contains information about contributing to TYPO3 documentation,
writing documentation for TYPO3 extensions and formatting with
-reST and Sphinx.
+reStructuredText (reST).
----
-.. container:: row m-0 p-0
+.. card-grid::
+ :columns: 1
+ :columns-md: 2
+ :gap: 4
+ :class: pb-4
+ :card-height: 100
- .. container:: col-md-6 pl-0 pr-3 py-3 m-0
+ .. card:: Migration
- .. container:: card px-0 h-100
+ Migrate your documentation to the new, PHP-based reST rendering.
- .. rst-class:: card-header h3
+ .. card-footer:: :ref:`How to migrate to the new rendering `
+ :button-style: btn btn-secondary stretched-link
- .. rubric:: :ref:`Migration `
- .. container:: card-body
+ .. card:: Cheat sheet: reStructuredText
- Migrate your documentation to the new, PHP-based reST rendering.
+ Go tho the cheat sheet containing a quick overview on how to use reStructuredText.
-.. container:: row m-0 p-0
+ .. card-footer:: :ref:`Go to the reST Cheat sheet `
+ :button-style: btn btn-secondary stretched-link
- .. container:: col-md-6 pl-0 pr-3 py-3 m-0
+ .. card:: Edit on GitHub
- .. container:: card px-0 h-100
+ This chapter explains how to apply quick changes to the documentation
+ you are reading by applying the "Edit on GitHub" workflow. All you
+ need is a GitHub account.
- .. rst-class:: card-header h3
+ .. card-footer:: :ref:`How to make quick fixes `
+ :button-style: btn btn-secondary stretched-link
- .. rubric:: `Extension Documentation `__
+ .. card:: Local rendering
- .. container:: card-body
+ Using your local machine instead of editing documentation on GitHub has
+ many advantages, it includes the freedom to choose which IDE you make
+ your changes in and it also gives you the ability to experiment and
+ preview your changes locally before submitting them for approval.
- This chapter explains how to write documentation for a new extension.
+ .. card-footer:: :ref:`How to work locally with documentation `
+ :button-style: btn btn-secondary stretched-link
- .. container:: col-md-6 pl-0 pr-3 py-3 m-0
+ .. card:: Extension documentation
- .. container:: card px-0 h-100
+ This chapter explains how to write documentation for a new extension.
- .. rst-class:: card-header h3
+ .. card-footer:: :ref:`How to document an extension `
+ :button-style: btn btn-secondary stretched-link
- .. rubric:: `TYPO3 Documentation `__
+ .. card:: System Extensions
- .. container:: card-body
+ The chapter contains information on how you can make changes to system extension documentation.
- Explains how you can contribute and help improve TYPO3's documentation.
+ .. card-footer:: :ref:`How to document system extensions `
+ :button-style: btn btn-secondary stretched-link
- .. container:: col-md-6 pl-0 pr-3 py-3 m-0
+.. toctree::
+ :hidden:
+ :caption: BASICS
- .. container:: card px-0 h-100
+ About
+ HowToGetHelp
+ BasicPrinciples
+ GeneralConventions/Index
+ WritingReST/Index
- .. rst-class:: card-header h3
+.. toctree::
+ :hidden:
+ :caption: HOWTOS
- .. rubric:: `System Extensions `__
+ Migration/Index
+ WritingDocForExtension/Index
+ WritingDocsOfficial/Index
+ RenderingDocs/Index
- .. container:: card-body
+.. toctree::
+ :hidden:
+ :caption: ADVANCED
- The chapter contains information on how you can make changes to system extension documentation.
+ HowToAddTranslation/Index
+ GeneralConventions/ReviewInformation
- .. container:: col-md-6 pl-0 pr-3 py-3 m-0
+.. toctree::
+ :hidden:
+ :caption: MAINTAINERS
- .. container:: card px-0 h-100
+ Maintainers/Index
- .. rst-class:: card-header h3
+.. Meta Menu
- .. rubric:: `Third-party Extensions `__
+.. toctree::
+ :hidden:
- .. container:: card-body
-
- This chapter explains how you can about making changes to third-party extension documentation.
-
-.. toctree::
- :hidden:
- :caption: BASICS
-
- About
- HowToGetHelp
- BasicPrinciples
- GeneralConventions/Index
- WritingReST/Index
-
-.. toctree::
- :hidden:
- :caption: HOWTOS
-
- Migration/Index
- WritingDocForExtension/Index
- WritingDocsOfficial/Index
- RenderingDocs/Index
-
-.. toctree::
- :hidden:
- :caption: ADVANCED
-
- HowToAddTranslation/Index
- GeneralConventions/ReviewInformation
-
-.. toctree::
- :hidden:
- :caption: MAINTAINERS
-
- Maintainers/Index
-
-.. Meta Menu
-
-.. toctree::
- :hidden:
-
- Sitemap
+ Sitemap