Hi Mat Very interesting. A few thoughts:
* We may want to declassify some of these concepts to keep the overall number down; it's quite overwhelming at the moment. ** For example "InfoList" could perhaps be tagged "Features" instead of "Concepts", as it doesn't really introduce any new mental concepts * We may want to separate out the "advanced" concepts, again the keep the main list reasonable > BTW, that list in the tiddler Concepts would be more informative if there really was a brief description next to each item a bit like here (...but more formal). The description could be a transclusion of the summative introductory paragraph that typically exist in those tiddlers, or if they have a summary field or such. I posted a github isse. I'll respond over on GitHub to the issue > Another proposal is a themed Hangout, dedicated to the Concepts, with Big J and the wizards talking about the concepts in a general sense. (I could pretend to NOT be an expert grandmaster hacker and ask the dumb questions, almost as if I didn't know how to code. I can be a very convincing actor in this role.) That could be a good idea. I'd certainly be interested to explore a hangout that was structured in that way. Best wishes Jeremy On Sat, May 9, 2015 at 1:51 PM, Mat <[email protected]> wrote: > As a part of a greater "Learning TW" project (if "project" is the right > word?), here is an introductory run through of the identified Concepts > <http://tiddlywiki.com/prerelease/#Concepts> in TW. > > Please help to improve it - not only the factual errors that I *for sure* am > making, but also to make it generally to make it a valuable list for > newcomers. > > > It is intended as a "priority list" that newcomers can reference. And that > *we* can reference newcomers *to*. > > I have selected the "concepts" as a good starting point (...after the > newcomer has read the very introductory material, and played around a bit) > as opposed to, say, a listing like the Definitions > <http://tiddlywiki.com/prerelease/#Definitions> or Features > <http://tiddlywiki.com/prerelease/#Features> because learning about the > Concepts is more close to *mastering* TW. It is also not as specific as, > say, a study in FilterOperators > <http://tiddlywiki.com/prerelease/#Filter%20Operators>. BTW, listings > such as FilterOperators serve more as a reference than as learning material > but I'm very happy to note that this list has added notes about which are > the most common operators. > > Apropos "Reference material" vs "Learning material"; Note that the listed > comments below are intentionally NOT presented a perfect structure but > instead in a semi-verbose style that convey *relative* importance *better* > than a strict factual format does. This is a typical major difference > between official reference material and e.g learning in a more live > context. But of course, it must not be factually false. > > > I will update this post with your input. > > > *A subjective Good to Start With list* > > *Target audience*: > New to TW and not particularly competent coder. (I'm limited to this > audience because of my own competence on the matter. With your help I hope > the target audience can widen.) > > Recommended reading for beginners are marked with *Beginner.* Concepts > with *Fundamental* or *Useful* can also be good to study but perhaps at > other levels. The comments typically refer to *the topic of* the listed > tiddler, not the tiddler itself... even if the tiddler itself probably is > the best starting point for closer study. > > > - ColourPalettes <http://tiddlywiki.com/prerelease/#ColourPalettes> - > Advanced. Limited use (but of course the term ColorPalette and its end-use > are basic) > - Commands <http://tiddlywiki.com/prerelease/#Commands> - Advanced. > Concerns the node.js version, and probably fundamental there. > - Current Tiddler <http://tiddlywiki.com/prerelease/#Current%20Tiddler> - > Intermediate. Useful. For the special, but frequent, case when code needs > to refer to "this" tiddler > - DataTiddlers <http://tiddlywiki.com/prerelease/#DataTiddlers> - > Advanced. Probably very useful. > - Date Fields <http://tiddlywiki.com/prerelease/#Date%20Fields> - > Intermediate. Limited use. In addition to the three default fields > "title","tags" and "text", you can add a date field specialized for showing > dates. > - DictionaryTiddlers > <http://tiddlywiki.com/prerelease/#DictionaryTiddlers> - Advanced. > General use. Tiddlers listing "name:value" pairs. > - Dominant Append <http://tiddlywiki.com/prerelease/#Dominant%20Append> - > Advanced kink. Specific filter technique. > - ExternalImages <http://tiddlywiki.com/prerelease/#ExternalImages> - > Beginner. Useful. Note it's a concept, not just a term for using external > images. > - Filter Operators > <http://tiddlywiki.com/prerelease/#Filter%20Operators> - Fundamental. > The "actions" used in filters. > - Filters <http://tiddlywiki.com/prerelease/#Filters> - Fundamental. > Beginner-Advanced. > - Hard and Soft Links > <http://tiddlywiki.com/prerelease/#Hard%20and%20Soft%20Links> - > Intermediate. Limited use. Refers to hard coded links vs links that are > constructed. > - InfoPanel <http://tiddlywiki.com/prerelease/#InfoPanel> - Beginner. > It's just the name for a panel you see via the toolbar. ("Toolbar", btw, is > a more important Concept.) > - JSONTiddlers <http://tiddlywiki.com/prerelease/#JSONTiddlers> - > Beginner. Good to know about even if you might not use right away. > - Macros <http://tiddlywiki.com/prerelease/#Macros> - Intermediate. > "Miniprograms" to perform otherwise repetitive tasks. > - Messages <http://tiddlywiki.com/prerelease/#Messages> - Advanced. > Widgets send messages in the system to e.g trigger stuff. > - Modules <http://tiddlywiki.com/prerelease/#Modules> - Advanced. > JavaScript tiddlers. > - ModuleType <http://tiddlywiki.com/prerelease/#ModuleType> - > Advanced. Specific for when building modules. Unsure how to describe. > - Order of Tagged Tiddlers > <http://tiddlywiki.com/prerelease/#Order%20of%20Tagged%20Tiddlers> - > Beginner. Not sure I'd classify this as a "concept", but OK. > - PermaLinks <http://tiddlywiki.com/prerelease/#PermaLinks> ...and > PermaView - Beginner. "Permanent links", i.e the URL to open a TW with > specific tiddlers open. > - Plugins <http://tiddlywiki.com/prerelease/#Plugins> - Fundamental. > Beginner to use, Intermediate with Andreas Hahns project. Consists of > several tiddlers bundled into one. > - Pragma <http://tiddlywiki.com/prerelease/#Pragma> - Advanced. > Special term. > - Selection Constructors > <http://tiddlywiki.com/prerelease/#Selection%20Constructors> - > Advanced. Possibly useful to know. > - ShadowTiddlers <http://tiddlywiki.com/prerelease/#ShadowTiddlers> - > Advanced. But fundamental to know that it means "Plugin tiddlers" > - SystemTags <http://tiddlywiki.com/prerelease/#SystemTags> - > Fundamental. The tiddler has a good rundown list not unlike this one! > - SystemTiddlers <http://tiddlywiki.com/prerelease/#SystemTiddlers> - > Fundamental. Possibly *defined as* (?) tiddlers starting with "$:/" > (or is it defined as tiddlers building up the system?) > - Tagging <http://tiddlywiki.com/prerelease/#Tagging> - Absolute > beginner. Tag to categorize things. > - TagTiddlers <http://tiddlywiki.com/prerelease/#TagTiddlers> - > Fundamental but practically just a term. (There is no official term for the > "opposite", but I'd call it a "pure tag") > - TemplateTiddlers <http://tiddlywiki.com/prerelease/#TemplateTiddlers> - > Intermediate. Very useful if you want to reuse content. > - TextReference <http://tiddlywiki.com/prerelease/#TextReference> - > Unsure of what this is/means. > - TiddlerFields <http://tiddlywiki.com/prerelease/#TiddlerFields> - > Beginner. Fundamental. The parts which make up a tiddler, e.g the title > field, the text field, etc. > - TiddlerLinks <http://tiddlywiki.com/prerelease/#TiddlerLinks> - > Beginner. It's the titles you can click on. > - Tiddlers <http://tiddlywiki.com/prerelease/#Tiddlers> - Fundamental. > Beginner. > - TiddlyWiki <http://tiddlywiki.com/prerelease/#TiddlyWiki> - Shared > term for TW classic and TW5 > - TiddlyWiki5 <http://tiddlywiki.com/prerelease/#TiddlyWiki5> - The > modern version of TW. Not compatible with "TW classic" (a.k.a TW2.x) > - Title List <http://tiddlywiki.com/prerelease/#Title%20List> - list > of tiddler titles > - Title Selection <http://tiddlywiki.com/prerelease/#Title%20Selection> - > Term of limited use. > - Transclusion <http://tiddlywiki.com/prerelease/#Transclusion> - > Beginner. Fundamental. Watch another place like through a TV. > - Variables <http://tiddlywiki.com/prerelease/#Variables> - > Intermediate. Fundamental. (I have no easy sentence to comment on this.) > - Widgets <http://tiddlywiki.com/prerelease/#Widgets> - Fundamental. > Beginner/Intermediate. The "html-elements of TW". > - Wiki <http://tiddlywiki.com/prerelease/#Wiki> - Say what? Hickey > <http://en.wikipedia.org/wiki/Hickey>? > - WikiText <http://tiddlywiki.com/prerelease/#WikiText> - Fundamental. > Simplified commands in edit view for formatting text and running widgets. > > > > BTW, that list in the tiddler Concepts > <http://tiddlywiki.com/prerelease/#Concepts> would be more informative if > there really was a brief description next to each item a bit like here > (...but more formal). The description could be a transclusion of the > summative introductory paragraph that typically exist in those tiddlers, or > if they have a summary field or such. I posted a github isse > <https://github.com/Jermolene/TiddlyWiki5/issues/1717>. > > Another proposal is a* themed Hangout*, dedicated to the Concepts, with > Big J and the wizards talking about the concepts in a general sense. (I > could pretend to NOT be an expert grandmaster hacker and ask the dumb > questions, almost as if I didn't know how to code. I can be a very > convincing actor in this role.) > > > <:-) > -- Jeremy Ruston mailto:[email protected] -- 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 http://groups.google.com/group/tiddlywiki. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/CAPKKYJaP2BU4ebQs_p8FAmHXv38-xdagQF8fmwxyN3nd4qwwMw%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
