[TYPO3-doc] Migration of doc_template completed (for extension developers)

[Fabien Udriot]

> 
> Yes. I totally agree. Wherever I can I make that extra source folder
> too. With one addition: lets move the conf.py one level up so its
> lying alongside the Makefile. 

I have some concerns with the hierarchy bellow. Let me explain.

First of all, this is about *extension* documentation and not *official* documentation as a
preliminary note to dispel confusion.

Documenting is *not* the Core business of a developer which has other problematic to solve.
Furthermore we want to iron out the path as much as possible. Everybody will agree until now ;)
Based on that:

* I would keep the hierarchy as simple as possible by keeping everything at the same level (no
source folder). If you want to get more complex because of extended manual, Fine! But not in the
Extension Template which should stay as easy as possible.

* build folder should not be under a source control IMO. It should be another service on-line. If
the developer is off-line, then he / she can read the reST files that is meant for that after all.
Again this is an effort (not big but still) to keep the build up to date in the extension and I
already feel the mess by having developer not maintaining it properly.

> If you ask me our Git repositories should look like this:
> 
> Example.git
> |-- ((room for payload, like extension code))
> |-- Documentation
>>   |-- Makefile
>     |-- conf.py
>>   |-- source
>>   |   |-- Index.rst
>     |   |-- ((conf.py -- not here!)) 
>>   |   |-- whatever-directory-and-file-structure
>>   |-- locale
>>   |   |-- fr/LC_MESSAGES/*.mo (not stored in Git)
>>   |   |-- de/LC_MESSAGES/*.mo (not stored in Git)
>>   |   |-- source
>>   |       |-- fr/*.po (coming from Pootle to have a local/Git
>>   |           backup)
>>   |       |-- de/*.po (coming from Pootle to have a local/Git
>>   |           backup)
>>   |-- build
>>       |-- html
>>       |-- ...
>>       |-- locale/*.pot
> 
> 
> sphinx-build has the -c option to specify where the folder with the
> conf.py file. So I simply use the current dir in the Makefile:
> 
>   sphinx-build -c . ((...))
> 
> Martin
>