@Alvaro, Thank you! you explained what I mean
Best wishes Mohammad On Tue, May 25, 2021 at 5:35 PM Álvaro <[email protected]> wrote: > 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 > <https://groups.google.com/d/msgid/tiddlywiki/6392aca0-770a-4ccc-9d3c-42f503e68d88n%40googlegroups.com?utm_medium=email&utm_source=footer> > . > -- 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/CAAV1gMAV0jNE51vJ9YY9eVZejC-Vc1VD%2BGxgND%2BhJqSzsuNk4g%40mail.gmail.com.
