Mark S. I agree with all you wrote. And I hear and see the frustration. In my own case, more observer than doer, I find the main Github very UNsatisfying to even read.
IMO, we are locked into a "two-men-and-one-dog" problem ... the demands seriously ahead of fulfillment from lack of workers. And the few people committed in it can't possibly keep up. Regarding the OP ... I think its best thought of as part of some kind of strategic "outreach" someone interested needs do (enthusiast like TonyM?), rather than demand on a central system that can't cope. Best wishes Josiah On Saturday, 3 November 2018 15:17:10 UTC+1, Mark S. wrote: > > 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/5ddf592d-480d-43ed-9b49-feca5c6522ff%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
