@Mohammad I haven't read all of this thread, but I did notice that the descriptions of filter expressions in the pre-release documentation seem to be missing important info. Eg. they should have a "purpose" and "parameter" field: https://tiddlywiki.com/#putafter%20Operator On Tuesday, 25 May 2021 at 16:18:24 UTC+1 Mohammad wrote:
> On Tue, May 25, 2021 at 4:55 PM TiddlyTweeter <tiddly...@assays.tv> wrote: > >> 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! >> >> > Let me think the problem is in the main documentation. From the filter > operator docs, I cannot understand what it does! > > > >> 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. >> > > Agree! but I think the format of docs for filter ops need some more > clarification! See example in my above post! > > One other example > > subfilter="[tag[HelloThere]] +[putfirst[]]" > > Did you know, in the above example putfirst takes the last item of > [tag[HelloThere]] why? As a newbie how can I understand this? > > > Another example > > putafter Operator > <https://tiddlywiki.com/prerelease/#>8th November 2015 at 8:48am > Filter OperatorsListops OperatorsOrder Operators > input <https://tiddlywiki.com/prerelease/#Filter%20Syntax> a list of items > suffix <https://tiddlywiki.com/prerelease/#Filter%20Step> an integer N, > defaulting to 1 > output re-ordered list of items > putafter what? I need to know putafter needs a filter > > [image: image.png] > > > >> IMO, Jeremy Ruston has done a very good job on documentation. >> > > You know, I am a big fan of TW! > > > >> >> It is true his style is somewhat gnostic :-) >> The original minimalist! :-) >> But it is also true that he has ASTUTE BREVITY. >> > > I think simple is the best but clear! > >> >> IMO this issue should be about SECONDARY documentation. >> > > I think we need to help. > > > >> >> 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. >> > > Sure! Thank you > >> 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 tiddlywiki+...@googlegroups.com. >> > To view this discussion on the web visit >> https://groups.google.com/d/msgid/tiddlywiki/9b4500a8-cf8e-46f5-bdc4-2c8f66ff0269n%40googlegroups.com >> >> <https://groups.google.com/d/msgid/tiddlywiki/9b4500a8-cf8e-46f5-bdc4-2c8f66ff0269n%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 tiddlywiki+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/9a60f668-6f2d-416d-abc4-b8cbba396201n%40googlegroups.com.