notice - This information is outdated
This page is a presentation of work and goals of the Documentation Team ("DocTeam").
We take care for the official TYPO3 documentation and the things related to it. This includes the official manuals, which are specially referenced in the "Documentation" section on typo3.org, and information on this wiki. We also have an eye on the structure of pages here in the wiki.
To get a more detailed overview of what we do, have a look at our current projects:
You can attend our projects, just contact us [deprecated wiki link]. Sorted by current priority:
| Link | 1. Official Documenta tion [d eprecated wiki link] | 2. ReST migrat ion [d eprecated wiki link] | 3. Online ReST Editor [d eprecated wiki link] | 4. Online TSRef [d eprecated wiki link] | 5. Solr search index of the wiki [d eprecated wiki link] |
| Aim | Create, update and translate the official TYPO3 manuals | Change the infra structure of the manuals from O penOffice .sxw to ReST | Easily edit manuals in ReST format online in WYSIWYG mode | Provide the TSRef online browsable with stable speaking URLs, provide it as PDF, provide the XML for the t3editor extension | Provide the page list for the Solr search engine on typo3.org |
| Who | Many people | Francois, Ben, Sabine, Susanne, Fabien, qual ity-check by Robert, we all as customers | Francois, Ben, Sabine, Susanne, Fabien, Tobias, Martin, Lenya CMS c ommunity, qual ity-check by Robert, we all as customers | Francois, Martin, Edwards, Nightfly, Flyguide | maybe Jo, Ingo as customers |
| Link | Wiki Design Rebrush [deprecated wiki link] | SSO for the wiki [not available anymore] |
| Aim | Give the TYPO3-Wiki a nice rebrushing | Make logins possible with www.typo3.org accounts |
| Who | Sabine, Fabien, Daniel, we all as customers | Dietrich Heise, Helmut Hummel, we all as customers |
| Time frame | 2010, finished March 2011 | 2011, finished December 2011 |
Smaller ToDos are available in thedocteamproject on forge.
- DocTeam Members list and Git repository
- Official Documentation for TYPO3 Version 4.x and 6.x (manuals)
- Documentation Team page on www.typo3.org
The team meets up on a regularly basis - every four weeks - to discuss about goals and evolution of the project. The reports of the meeting are available online: DocTeam Meetings. If you would like to participate to such meetings and help around don't hesistate to contact Francois Suter [not available anymore].
Classification of roles, states and tags used in documentation (draft, you`re welcome to edit) DocTeam/ContentClassification [deprecated wiki link]
Discussion about challenges and goals of TYPO3 documentation DocTeam/ChallengesAndGoals [deprecated wiki link]
The new vision of Documentation Team DocTeam/New vision [deprecated wiki link]
Support for good documentation is our mission.
That means for us:
- We want to provide exhaustive, quality documentation about TYPO3 for all users, with the help of the community.
- Anyone is welcome to develop tools that help further the understanding of TYPO3.
- Anyone is welcome to help writing high quality materials which are easy to use and easy to learn.
In order to achieve this, it pursues the following goals:
- write and maintain official documentation, whose quality is ensured by peer review
- provide a tool for the participative creation of documentation (wiki)
- care for the "Documentation" section of typo3.org and any other relevant pages
- support the TYPO3 Core Team and any other team in their documentation efforts
- encourage the creation of online tools for easy reference to TYPO3's main languages and APIs, ensure quality and maintenance
- encourage the creation of any other tool which favors documentation and understanding of TYPO3
- encourage the translation of the documentation
- act as Community Managers to involve as many folks from the community as possible
- manage the teamwork
- define and control the compilance with wiki rules and content structures
- Francois Suter (francois)
Have a look at the DocTeam Member profiles on forge.typo3.org to see who we are.
- Daniel Brüßler (patchworker)
- The Server Administration Team [not available anymore] (e.g. Steffen Gebert [deprecated wiki link], Fabien Udriot [deprecated wiki link]...) takes care for the Server (PHP, MySQL).
Feel free to create a user account and participate on high quality TYPO3 documentation. When you are a beginner, please look at the help`n beginners section or ask the DocTeam Members.
You want to participate? You have a question? You want to help? Please contact us:
- Send us an e-mail [not available anymore] or
- Tell us what you want to do in our newsgroup "typo3-project-documentation"
How to write documentation; the rules, templates, tips and tricks. Also something about why we write documentation in a certain way.
- Help [deprecated wiki link] for editing and creating wiki pages
- General guidelines [deprecated wiki link] on how to write documentation
- Information about images in documentation [deprecated wiki link]
- Writing in an alternativ language
- How to use Wink [deprecated wiki link] to make small flash tutorials
Before moving our documents to reST format, we used OpenOffice to maintain them. These information were helpful back then:
- How to update an OpenOffice manual with changes made in the wiki: DocTeam/Update OpenOffice manual from the Wiki [deprecated wiki link]
- How to upload Open office documents to typo3.org [not available anymore]
- How to convert OpenOffice documents to Wiki format [deprecated wiki link] about writing documentation