How to Read This Guide

This manual introduces you to writing TYPO3 documentation. You can read it cover-to-cover.

But often, you would like to jump right in, start with a specific task and learn as you go along. In that case, pick a task in the list below.


Before you start, we recommend that you read Basic Principles to familiarize yourself with the structure and reStructuredText & Sphinx Introduction. Additionally, keep the reST & Sphinx Cheat Sheet handy to look up the syntax.

Find your task here and start reading:


This document was originally written by Martin Bless.

Special thanks goes to Xavier Perseguers for writing some of the original texts on the TYPO3 Wiki and elsewhere. Part of the texts have been moved to this document or at least used as a basis.

Further chapters like Common Pitfalls, reST & Sphinx Cheat Sheet, How to Contribute to Official Documentation, Basic Principles, How to Document an Extension and How You Can Help were added by Sybille Peters.

A number of other people have helped by reviewing and refining the text and pointing out missing information. For more contributors, see the list of contributors on GitHub for this manual.

We thank everyone for their help and hope that good documentation about writing documentation will make it easier for others to contribute.