Bob,

When reading the documentation on tiddlywiki.com the intention is for the 
content to be displayed in the view template.

Editing the tiddler exposed the documentation macros 

<<.operator-example 1 "[[23]add[19]]">>

This is calling the .operator-example and is not itself documented for the 
reader.

As a community we are always looking for help enhancing the documentation, 
but a lot of members have documented a lot elsewhere. It is quite easy to 
submit simple documentation updates on tiddlywiki.com if you have a github 
account.

As for filters the information is all there, technically, and yes not in 
one place, but the application and extensibility means further 
documentation is necessary to empower users. There are many resources 
around. Most recent is some of Mohammad's work, look for his library of 
plugins, the first port of call is possibly the community links on 
tiddlywiki.com and Davids TiddlyWiki Toolmap  
<https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM>

Yes, we have a distance to go, but fast innovation can cause a drag in 
documentation.

Regards
Tony

On Monday, 14 September 2020 11:54:09 UTC+10, Dr. Bob Jansen wrote:
>
> Eric, 
>
> thanks for your reply and it does make sense. However, as an old-timer 
> XML guy, leaving out the close tags is 'difficult'. Also it makes for an 
> exception and I abhore exceptions to markups cause experience shows 
> exceptions breed exceptions which in turn breed........ 
>
> A final comment, the documentation of TiddlyWiki is all over the place. 
> As a newbie, I find it difficult to find answers to my issues. The 
> examples don't always make sense especially those that are coded to a 
> macro, like <<.operator-example 1 "[[23]add[19]]">> in the Add Examples 
> tiddler. This does not help me work out the syntax or use of an item. 
> The writer assumes the reader is familiar with things and is looking for 
> a refresh. Where does one look for the .operator-example tiddler, search 
> doesn't find it? 
>
> This is especially true for documentation about filters. From what I 
> have gleaned so far, filters are the concept that makes things work and 
> as such an important central concept that I would expect similarly sized 
> and detailed documentation with lots and lots of examples. 
>
> I am not trying to be negative but positive, for future newbies 
>
> bobj 
>
> -- 
> -------------------------------- 
> Dr Bob Jansen 
> 122 Cameron St, Rockdale NSW 2216, Australia 
> Ph (Korea): +82 10-4494-0328 
> Ph (Australia) +61 414 297 448 
> Resume: http://au.linkedin.com/in/bobjan 
> Skype: bobjtls 
> KakaoTalk: bobjtls 
> http://cultconv.com 
>
> In line with the Australian anti-spam legislation, if you wish to receive 
> no further email from me, please send me an email with the subject "No 
> Spam" 
>
>

-- 
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/b5a9d166-536c-4c7d-8edf-913fc33bfd76o%40googlegroups.com.

Reply via email to