Strangely, I often find myself doing things differently from day to day.  
Maybe mood-related, maybe because I do like to try things differently to 
test or firm up my understanding.

When I use something, though, in order to help me sort things out (i.e. 
getting intertwingularity to submit to my will !), I desperately need 
consistency.

Hence my slow and sporadic attempt to create TiddlyWiki documentation that 
works for me (https://groups.google.com/g/tiddlywiki/c/cwCkCaiJG_g)

For example of an annoyance, the WidgetMessage: tm-modal 
<https://tiddlywiki.com/#WidgetMessage:%20tm-modal> documentation tiddler.

The top part of the documentation, in the table, defines one of the 
message's parameters as "*param*".

But in the examples, it is clear that the parameter is actually "*$param*" 
when the message is used with the $action-message widget..

And then, $param is for the title of a tiddler.

But in other widgets, "tiddler" is the parameter for the title of a tiddler.

And when we look at the parameters for various widgets, sometimes we have 
parameters with $ prefixes, other times we don't.

Inconsistency is confusing.

And creating documentation that works for me is slowed down because to get 
the documentation "right", I find myself having to wrap some of the widgets 
with macros, and suggesting the use of the macros instead of direct use of 
the widgets.

Messy.


-- 
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/675007a9-0f83-4dc5-a5d7-cbbb98417003n%40googlegroups.com.

Reply via email to