Ciao TonyM I'm replying here from a particular perspective. One of the Reluctant Crap "Forced" Programmer. I like what TW can do. I loathe having to fiddle around trying to get something done (one way around this would be to have a route to pay people to do it for me--but that is another issue).
I'm perhaps in a small minority that is seriously cognitively challenged by procedural computer logic. I find the documentation at tiddlywiki.com tantalizingly suggestive. And then I'm lost for a while. The FIRST thing that would help me is a few fully-worked though EXAMPLES based on working towards an explicit final functional USAGE aim (e.g. "How to write, index and print a cookbook" or "Ways to create a photo album for grannie"). Material, real, implemented solutions documented in detail would illustrate things in a way that suits my learning style. I'm not sure whether others have my problem so extreme. A SECOND thing that would help me is CRIB SHEETS--i.e. succinct overviews of functions with fuller example sets. Some of the things Tobias Beer authored along those lines (like is stuff on filters) are excellent, though beginning to age now. Best wishes Josiah On Tuesday, 28 November 2017 23:40:51 UTC+1, TonyM wrote: > > 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/9f1197b0-fa01-4247-8b31-8afb632770bd%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
