On Tue, May 25, 2021 at 4:55 PM TiddlyTweeter <[email protected]>
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 [email protected].
> 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 [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/CAAV1gMB0N3_B7fqcM5rbFc592FVcFOi52SyFb3C8OH3v72f-Sg%40mail.gmail.com.

Reply via email to