[TYPO3-doc] DocBook: storage structure

[Fabien Udriot]

>
> The tutorials are really meant to be step-by-step instructions to discover a given topic. Guides are
> meant to be in-depth explanations of some subject. This is quite different.

Ok, but in this case, this is something that should be explained somewhere (if not already) because 
the nuance wasn't clear at all for me.

> Personally I think we should detach documentation from the TER. The goals are so different. The TER
> is about making extensions available. Of course, these extensions many have manuals, but the TER is
> not designed to handle documentation in a satisfactory way and I would say it's outside of its scope
> to do so.

100% agreed. By now, there is already some separation if you think there is "ter_doc" extension to 
render the documentation and "ter_fe" to handle the FE display. Obviously, at one point there must 
be some pointer on the TER FE to the documentation (like it is the case today)

> If we manage to have a global repository for the whole documentation - extensions included - we can
> make it all accessible directly, via its own frontend. Manuals would not have to be artificially
> packages as extensions anymore.

Yes!

>> - It should be a language separation for every node, shouldn't it? I mean:
>
> Yes, but I prepared that structure manually, so I just made one example ;-)

Ok, good.

Fb.