short explanation and one-two examples of usage, that's it. That's the
difference between reference manual and user's guide - the former just
gives you a list of options, the latter really teaches you what to do with
these options, in which cases and why.
and the best of them is BOTH, having a "list of options" and a
cases "what to do with them, in which cases and why", but *not*
how, maybe roughly. An implementation guide should really appear in a
tutorial.
I think this solution is the most *useable*, our reference should serve
the need for experienced beginners, intermediates and experts (not raw rookies).
regards
--
o----------0-¬---------O-·---¬----o---®-----o o O ° .
| http://www.kiffen.de | pRoteçt y0ur bRaín |0 O ° ¤ °
·
0°·³°²'²³-¹'³´³°^°³~³²³°'³²²¨³²^³¹³²°²³`³º³°Þ °
o © ° . ·
| psychedelic experience | gott@kiffen.de | O ° o °
o-¬--o--0-----©-·--O-----o-----0-¤----------o 0 ° · ° . ¤ ·