I agree, it is confusing especially if you don´t know/remember the filter sintax, in this case the filter steps. And how you say input is confusing if you don't know/remember that this input is the output of other filter step (or filter run). If i don't understand bad the list of titles between square bracket is a step. I like the idea the "constructor example" in a list (or in filtering transclusión), I don't know if it is better do it with styles in font or in a table. I think that also differenciate the parts of constructor, necessary vs optional.
Also i agree with Stobot. "Example constructor" will be good point. I think also it happens with macro docs (for example in "toc" macro). I working in a macro and i doubt how write the optional parameters to do understandable to everyone. TiddlyTweeter, I agree with you in that brevety is good, but with some reminders it would be better and not much longer. El martes, 25 de mayo de 2021 a las 14:24:58 UTC+2, TiddlyTweeter escribió: > Ciao Mohammad > > It is an interesting issue. > > - I AGREE the base docs are not enough for working everything out. > > > - I DISAGREE that the solution to that problem should be in the main > documentation! > > WHY? > > Because *IF *you added all possible combination examples it would inflate > the main reference site, tiddlywiki.com, to be SO vast it would become > unusable. > > IMO, Jeremy Ruston has done a very good job on documentation. > > It is true his style is somewhat gnostic :-) > The original minimalist! :-) > But it is also true that he has ASTUTE BREVITY. > > IMO this issue should be about SECONDARY documentation. > > At the moment everything focuses on tw.com. > I'm NOT convinced that is the right approach for final practical, fully > expanded, documentation. > > It seems to me that we need more DIFFERENTIATION. > AND recognizing better SUPPLEMENTARY documentation that covers specific > aspects of TiddlyWiki in more detail would be best. > > I hope my points make sense, even if you don't agree. > TT > > > -- You received this message because you are subscribed to the Google Groups "TiddlyWiki" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/6392aca0-770a-4ccc-9d3c-42f503e68d88n%40googlegroups.com.
