Folks,

I plan to start contributing to the TiddlyWiki documentation. I want to 
spell out what I am keen to add, so wanted to open it for discussion before 
hand.

Please keep this discussion focused on what I propose if possible.

As my Newbie status fades I am still finding the documentation falls short 
of my needs, I would like to add to the documentation with everyone's help 
the following;


   - Examples (need not include "Try It")
   - *Provide full examples with the full statement eg using list or 
   list-links to demonstrate a filter*
      - So it can be copy and pasted into someones wiki
   - *Provide examples with placeholders for the major forms of a command*
      - The alternatives where a command has distinct applications
      - Allowing copy, paste and edit.
   - *Provide examples where values are pulled from the current tiddler*
      - Too many examples only have static tiddler names or literal strings
      - When building reusable macros and solutions we need examples of how 
      to extract values from the current tiddlers title, fields and tags.
   

I believe such examples will support newbie and expert alike and act as a 
more practical reference. Of importance it will help people get over the 
syntax and references humps TW5 presents, and make it easier to learn by 
example.

If people smarter than me can bring together all the ways and standards for 
references and transclusion into a single reference tiddler as well would 
be helpful as currently the different forms are all over the place.

Are there any other critical pieces of info needed?

What do you think?


-- 
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 post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/cb814a97-f716-4692-92f9-53ae855468a1%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to