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

[Dan Osipov]

What I mean by reference is a pocket guide - a few pages at most with 
minimum description. The rest of it should go into the documentation.

Here is an example reference for regular expressions:
http://networking.ringofsaturn.com/Web/regex.php
Obviously aimed at someone who has read a tutorial & knows what its all 
about.

Dan Osipov
Calkins Media
http://danosipov.com/blog/

Martin Holtz wrote:
> 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