[TYPO3-doc] Documenting TypoScript constants (and more)

[Martin Holtz]

Hi Dan,

> References should be kept separate from the rest of documentation, but
> at this point TSRef is much more than a reference - its a huge document
> with a lot of explanations. It would help to describe the TS basics, and
> then move to TSRef, and have a lightweight reference just to remind
> people of the syntax.
i do not see, why it should be helpfull to keep the references separate
form the rest of documentation?

I think it is a good idea to have examples and comments together with
the reference. So if someone could easily see how it is intended to use
an option. It is IMHO very helpfull for beginners.

Can you explain it to me?

thanks,
martin