h1. Documentation Team Meeting Minutes 2012-11-15 ##h2. Attendees Martin Bless, Michael Schams, Christopher Stelmaszyk, François Suter, Fabien Udriot ##h2. Official manuals * status of Templating tutorial: **((to be added by Christian))** * status of Maintenance Guide: ** news announcement published, currently 2-3 new members. ** instruct people to use the wiki (wiki.typo3.org). ** ask community about presentations that could be reused in the manual (look at Slideshare for ideas) * status of Security Guide: ** updates for TYPO3 6.0 and the new TYPO3 branding * other official manuals: ** general ReST work: headlines/folders renamed, labels, images) ** Christopher: TSref is nearly ready ** Christian started working on TSconfig ** François working on Core APIs * NOTE: there's now a list of all targets available in a given manual (listed at the end of the manual) ##**h2. Planning for 6.0 release / **typo3.org integration * Martin can test with the branches for 4.7 in the repos of TSconfig, TypoScript Reference and TCA. (Still has to be done) * our content can be cut out and pasted into the HTML pages of typo3.org ** could be handled by a plugin on typo3.org * Martin is working on a nice looking "t3org" theme for Sphinx that will produce static html files that are code compatible and layout compatible with typo3.org * Boris Hinzer (from typo3.org team) \& staff is working on the styling, good cooperation * A better rendering for the table rows is in the pipeline and close to appearance. This will make the Tsref readable again. But this automation will only affect those table rows that were in the style of the old Tsref "Object, Data Type, Description, Default" tables. * Martin: I'm planning to have \url{http://preview.docs.typo3.org/TYPO3} updated and carry the new design. I should then be at \url{http://preview.docs.typo3.org/typo3cms/} * As a fallback strategy we could switch the docs.typo3.org domain to the srv123 server, so as an intermediate solution we could have \url{http://docs.typo3.org/typo3cms/} in case the Flow3/task-queue rendering machine isn't ready. * Fabien: \url{http://forge.typo3.org/issues/41577} - work on rendering the whole documentation (srv130.typo3.org) * Fabien: \url{http://forge.typo3.org/issues/40375} - Synchronize documents from the rendering server to the delivery server * Fabien: (not a priority) second round on \url{http://forge.typo3.org/projects/get-the-docs} - Actual outcome \url{http://preview.docs.typo3.org/getthedocs/} ##**h2. Design of the new documentation** * A number of things still can be improved Two example pages you can check: \url{http://preview.docs.typo3.org/TYPO3/TyposcriptReference/Conditions/Reference/Index.html} [1] \url{http://preview.docs.typo3.org/TYPO3/TyposcriptReference/ContentObjects/Hmenu/Index.html} [2] (Feel free to add items below!) ** Syntax highlighting always uses PHP => Wrong highlighting in TypoScript code: *** override as needed in the manual's Settyings.yml file or per code blocj *** List of available languages: \url{http://pygments.org/languages/} * Tables: ** Martin: [1] has tables with short content. It makes sense to rewrite the ReST markup of those table really as "ReST simple tables" (like "Values and comparison") ** See \url{http://preview.docs.typo3.org/~mbless/DOCROOT\_HTDOCS/World/Docutils/html/docutils-docs/peps/ref/rst/restructuredtext.html#simple-tables} ** Martin: In [2] there is a typical "Tsref like" table at the beginning. Use the .. t3-field-list-table:: directive. It will then be automatically reformed and beautified by the Sphinx extension I'm working on ** For an example see \url{http://preview.docs.typo3.org/TYPO3/OfficialManualExample/\_sources/Chapter1/Index.txt} ##h2. Rebranding * no item to act on right now * discussion about technical impact still going on: ** see: \url{https://notes.typo3.org/p/renaming-technical-todo} * inside the manuals: ** to check as they are updated ##h2. Next meeting * Thursday, December 13th, 21:00 CET