[TYPO3-doc] rST rendering for contexts extensions

[Martin Bless]

Hi Christian,

>Hi,
>
>
>We provide rST-based documentation for our extensions contexts[1],
>contexts_geolocation[2] and contexts_wurfl[3] - all of them have
>an "Documentation/Index.rst" file that renders nicely with the sphinx
>extension in the TYPO3 backend.
>
>Now how do we get them to render on docs.typo3.org?
>
>
>[1] http://typo3.org/extensions/repository/view/contexts
>[2] http://typo3.org/extensions/repository/view/contexts_geolocation
>[3] http://typo3.org/extensions/repository/view/contexts_wurfl

Cool, that's really motivating to here that things start evolving
this way. You have chosen exactly the right way by telling us
here!

In the pipeline there is a notification service that Thomas
Löffler has on his agenda which should then notify the Docs-server
when something is uploaded to the TER.

And another thing that's missing at the moment is a script that
fetches complete extensions from the TER and renders their
./Documentation/...

There is an easy and quick solution though for now that I can
offer: You could create a repository for each of the three
extensions above at Github where the documentation is at
"./Documentation" (Documentation = subfolder of the top level).

Then: tell me the URLs of the repositories
(martin.bless at typo3.org).

And add hook processing to Github:
http://docs.typo3.org/typo3cms/drafts/github/marble/DocumentationStarter/Quickstart/DetailsStep5.html

If you then push Github, a new rendering of the documentation will
happen automatically.

Consider the whole thing a "workaround" as long has we don't have
a better machinery.

H.A.N.D - have a nice documentaiton :-)

Martin

-- 
Certified TYPO3 Integrator | TYPO3 Documentation Team Member

http://mbless.de