There's a lot of good documentation on TiddlyWiki.com. It just doesn't hang together in narrative form, and for some reason new users aren't discovering the friendly write-ups about filters and such.
Perhaps we could quiz new users about what they did and didn't find at TW when they went looking for answers. As for fixing docs at TW, I feel that is hopeless with the current situation. When you can spend an afternoon making documentation, and then have it ignored for more than a year ... well, I give up. I currently have 10 PR's outstanding. It is too frustrating. I've started on my own manual. I started it in Dynalist actually, but then switched to org-mode because it has more authoring tools (bookmarks, spell-check, etc.). But for a group-project it would need something like DL. It's hard to maintain the enthusiasm because the user base is so small -- you know, once someone learns something ... they're no longer a beginner! -- Mark On Saturday, November 3, 2018 at 6:29:58 AM UTC-7, David Gifford wrote: > > Just to be clear, what you are proposing is something inbetween empty.html > and tiddlywiki.com? An edition for newbies that has introductory > documentation and a few things preinstalled? > > My take would be that the documentation (most of your list) should stay on > tiddlywiki.com, rather than a parallel scaled down version that has to be > maintained separately. What is needed is to make a lot of the existing > documentation more user friendly for soccer moms and busy office workers. > The problem is that not everyone here can write in that way - they have > been techies for too long, and an explanation that sounds abundantly clear > to them - and is - is not clear at all for the rest of us. So they double > down on explaining the abstract definition of a filter or widget, thinking > that will help. Most of us couldn't care less about the definitions and the > concepts. We just want to know what we might use it for and how to use it > without destroying the Internet. > > I did some of the work - a number of the tiddlers at > https://tiddlywiki.com/#Working%20with%20TiddlyWiki back in 2014. And of > course the toolmap and my earlier "TW for the rest of us" and TiddlyVault > for classic TW. But I don't have time or knowhow to do much more nowadays. > > In addition to better documentation, we should have a) an array of > editions for various use cases and b) a library of one-function-only nearly > empty tws that have one thing - vertical tabs, a table of contents, etc - > and instructions on how to install that one thing and modify it, both for > mobile and for laptop. Then have links to these things on tiddlywiki.com > and the toolmap or whatever is cooked up to replace it. > > One issue is that it is less glamorous - and feels like a step backwards > - for most TW regulars to spend time looking at the basic stuff we learned > years ago in order to help others understand them. We would rather create > new cutting edge stuff. For some, that means new plugins. For me that means > new combinations of elements to create new workflows for my personal uses - > notetaking, organizing my ideas, web publishing, and productivity. It is > easy to feel we have too many important things to do at those levels, and > that doing documentation would be a boring chore and a bad use of our time. > But if a few key players could commit themselves to devote 2-3 hours a > month (or whatever) to evaluating and cleaning up documentation on > tiddlywiki.com, that would go a long way. > > okay that is my two cents for today. Blessings. > > On Saturday, November 3, 2018 at 1:03:42 AM UTC-6, TonyM wrote: >> >> David, >> >> Perhaps there should be a new user edition, empty is "as pure as the >> driven snow", and this is importiant for somewhat knowledgable users >> wanting a fresh copy when they need it. But I agree with you and Bimlas. >> Lets use this thread to build a list of things we would include in a new >> user wiki and make such an addition. >> >> We could even create a button to create or delete these additions. >> >> Toc already installed >> A home page in the toc with a set of guidence tiddlers below (abouts and >> high level how to tiddlers) most will link to tiddlywiki.com tiddlers. >> Eg; >> How to create tiddlers or "content" in tiddlywiki >> How to write in tiddlywiki markdown >> How to connect tiddlers with tags eg new here >> How to list tiddlers with the same >> How to backup your tiddlywiki >> How to save your work >> How to get or transfer content - tiddlers, bundles of tiddlers, plugins >> tag(s)/combination of tags >> How to find plugins via libraries, listings, search, googlegroups >> How to get help (search tiddlywiki.com, see find below, search gg, ask >> gg) >> How to find more learning resources >> How to find more resources >> How to make something appear on every tiddler >> About filters (built in first then make your own) filter operators >> About searching ( in sidebar, advanced search, search operator) >> About editions (empty, new user, others your own) >> About saving your work >> - default save >> - timimi >> - support plugins >> - get a server to save it for you from (file to http) >> About fields >> Glossary of terms common in tiddlywiki >> - file based or single file tiddlywiki >> - folder based wiki >> - transclusion >> - widgets >> - macros >> - plugins >> - bundles (of tiddlers) >> About mobile first >> About on your desktop >> About tiddlywiki as a platform >> About taas tiddlywiki as a service - tiddlyspot, noteself, maarfapad >> How to share tiddlywikis - file, taas, cloud, html, PHP server, nodejs, >> tiddlyserver, bob >> How to view tiddlywiki files - browser (file/html), apps with browsers >> built in - >> Did you know? >> - you can change the editor/use external editors >> >> More? >> >> -- 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/e7f2d7db-5709-48c7-9145-56bfaaf484b4%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
