h1. Documentation Team Meeting Minutes 2014-03-20
h2. Attendees
Martin Bless, David Denicolò, Xavier Perseguers, Michael Schams, François Suter
h2. Team
* New team member: David Denicolò
* Interested person, likely visitor to the code sprint: Guido Haase
h2. Code sprint
* Date: April 10-12
* Location: Fribourg, Switzerland
* All further details on the wiki page: \url{http://wiki.typo3.org/DocTeam/Code\_Sprint\_2014}
h3. Topics
* Status and inventory:
** inventory of current resources on docs.typo3.org (current notes by Martin: \url{http://docs.typo3.org/typo3cms/drafts/github/marble/IncomingNotes/DocsTypo3Org/Index.html)}
** status of Flow application
* Flow application
** blueprints by François
** knowledge sharing
** active coding
** finally use it on docs.typo3.org!
* Landing pages for docs.typo3.org
** concept
** design
** technical solution
* Miscellaneous
** implement Piwik tracking code
** Github contribution process:
*** extend to other manuals
*** add editing link on docs.typo3.org
* wiki.typo3.org
** brainstorm about what to do with old stuff in the wiki
h2. docs.typo3.org
* TER integration
** there are wrong links to manuals on \url{http://typo3.org/extensions/repository/} (example: \url{http://docs.typo3.org/typo3cms/extensions/gridelements/2.0.2)}
** happens because we don't use the same criteria for deciding whether some documentation is valid or not
** François (and Xavier) in contact with Christian Zenker to sort things out
h2. Official manuals
* Updated on time for 6.2 release
** TypoScript
** TSconfig
** TCA reference
** Core APIs
** TypoScript Syntax
** Coding Guidelines
** Security Guide
* Ernesto has been working on an updated Installation Guide
** hopefully changes can be merged before the release of TYPO3 6.2
* Next effort should be on Getting Started and Editors Tutorial
h2. Solr integration
* questions:
** what is needed on docs.typo3.org so that Solr can provide a faceted search into documentation again?
*** list of documents?
*** notifications about updates?
*** specify the <div> tag which contains the content
** search on docs.typo3.org
*** facets per product (CMS, Flow, Neos)
*** how can we use it?
* status:
** during their last codesprint the server team (Michael Stucki and Fabien Udriot) have been working on installing Nutch (crawler) and made substantial progress, but are stuck with one error.
** contact has been taken with people at dkd for help.
h2. Extension manuals
* Status here? Anything happened?
* Xavier wrote a reST primer: \url{http://docs.typo3.org/typo3cms/drafts/github/xperseguers/RstPrimer/}
* could be extended with advanced stuff:
** recommended markup for extension properties: \url{http://docs.typo3.org/typo3cms/extensions/restdoc/latest/Configuration/TxRestdocPi1/Index.html}
** cross-link to other manuals
* Example manual (\url{https://git.typo3.org/Documentation/TYPO3/Example/ExtensionManual.git)} should be updated to avoid duplication
** inform about possibility to use README.rst on Github
h2. Priorities
# Flow application (ongoing)
# Solr integration
## TER index page (done, but not quite right)
## documentation facet search on typo3.org
## search on docs.typo3.org
# Consolidation of tools and processes
# Document all our tools
h2. Miscellaneous
Nothing important for the minutes.
h2. Next meeting
* Thursday, April 17, 2014, 21:00 CEST