h1. Documentation Team Meeting Minutes 2014-08-21
h2. Attendees
Martin Bless, Philipp Gampe, Michael Schams, Christopher Stelmaszyk, François Suter
h2. docs.typo3.org
* Vagrant box
** No news from Peter Niederlag
* Flow application
** Jacob Floyd worked to improved the domain model
** Marc Neuhaus started implementing user authentication
** The TER is now sending signals to RabbitMQ after extension upload
* PDF rendering
** What needs to be done? How much budget will be used?
** Xavier gathering feedback from the community
* new (cleaner) HTML rendering
** use the budget from the JSON rendering
** activate JSON output
** Martin can use the budget from the "JSON output" milestone for this
** François to ask Xavier to follow with Martin (can use the "Project Management" milestone for this)
h2. Official manuals
* Move to Github
* New release scheme for TYPO3 CMS (reference: \url{http://wiki.typo3.org/Blueprints/Release} )
** Proposal to create a branch only for major version with goal to have stable doc by the time of LTS release
** BTW new branches still pending, wait for vote to be concluded
** Documentation is being written by Active Contributors as they go along
*** \url{https://git.typo3.org/Packages/TYPO3.CMS.git/tree/HEAD:/typo3/sysext/core/Documentation/Changelog/master}
*** this will greatly speed up integration once we start updating the official documentation
h2. Solr integration
* currently in outer space
h2. Extension manuals
* how to centralise user questions about manual rendering errors?
** can we post the warnings file somewhere)?
** if the rendering completes, the "warnings.txt" file can be accessed in "\url{http://docs.typo3.org/typo3cms/extensions/extension\_key/x.y.z/\_make/warnings.txt}"
*** there's a bug there currently, the warnings file is the same for all extensions (reported: \url{https://forge.typo3.org/issues/61130)}
* how to report on extension documentation "quality"
** Extension Builder (introduce a "quality" screen)? metrics.typo3.org? ci.typo3.org?
*** metrics.typo3.org and ci.typo3.org are currently awating new maintainers => no hope there for now
** points to check:
*** no documentation at all
*** still using OO format
*** no README.rst or no Documentation/Index.rst
*** folder Documentation.tmpl not renamed (from Extension Builder)
* Actions
** open a ticket in the TER Forge project (Done by François: \url{https://forge.typo3.org/issues/61131)}
** submit ideas to the community, to see if anyone pick them up (François)
h2. Priorities
# Flow application (ongoing)
# Solr integration
## TER index page (done)
## documentation facet search on typo3.org
## search on docs.typo3.org
# Consolidation of tools and processes (ongoing)
# Document all our tools (ongoing)
h2. Miscellaneous
* nothing
h2. Next meeting
* Thursday, September 18, 2014, 21:00 CET