h1. Documentation Team Meeting Minutes 2013-02-21
h2. Attendees
Christopher Stelmaszyk, François Suter, Fabien Udriot, Christian Wöbbeking
h2. Official manuals
* Templating tutorial
** now list officially on docs.typo3.org
** Christian checks with Christopher for updating the doc\_tut\_templating extension
** François making some corrections, then will publish an announcement
* TS in 45 Minutes tutorial
** clean up and update by Christopher
* Getting Started tutorial
** Christian replacing img directives by figure directives
* Core APIs
** update to at level of 4.7
h2. ReST migration for sysext manuals
* target 6.1
** yes, but prioritize improving the usability of docs.typo3.org for extension authors
** not a small task, because ReST markup needs to be cleaned up after migraiton
** how to view the documentation locally
** François talks with Benni
h2. docs.typo3.org
* handling of versions (stable, latest)
** default version should be the stable version (i.e. 4.7 or 6.0) and not latest (master)
** needs some menu to switch version
*** would ideally be based on "solid" data from the Flow application
* Flow application
** upgrade to Flow 2.0
** build a REST layer, but not stabilized yet in Flow
** refactor application, in particular being able to flexibly register sources of documentation (e.g. TER, Github, etc.)
** Fabien may not be available before May or June
* extension manuals
** improve the current extensions page (\url{http://docs.typo3.org/typo3cms/extensions/)}, by François, nearly done
** discuss with TER team about interactions:
*** trigger a job upon extension upload
*** give feedback about rendering
* Solr integration
** needs a page from which to crawl everything
** François to check again with Ingo, in particular with regards to faceted search (Flow, Neos, CMS)
h2. Priorities
Summing up the above, the priorities would be:
# extensions page improvements
# version switcher
# Solr indexing
# TER integration
# Flow application
# migration to ReST for 6.1 sysext manuals?
h2. Competitor workflow enabling documentation contributions
\url{http://framework.zend.com/manual/2.0/en/user-guide/overview.html}
\url{http://zf2.readthedocs.org/en/release-2.0.4/}
ZF hosts its documentation on Github. Any file can be edited online on Github. To do that ZF places an "Edit source" link in their files. The user is then invited to fork the repository, the file can be edited online and generate a pull request upon saving. This informs the owners of the master repository of the change, so that they can review and if it's OK integrate it.
Fabien submits proposal to ML.
h2. Miscellaneous
* next T3O code sprint
** Martin not attending
** Fabien maybe
h2. Next meeting
* Thursday, March 21, 2013, 21:00 CEST