As a business analyst for the last 20+ years.... Expecting community documentation NEVER works, not in a business and def not in the tech community (it does work well among fandom, but... That's not the same).
So what is needed, imho, is a committed team to address and collect documentation, and that would maintain going forward. They'd need to be people with skill at writing use docs too (to address some of the too terse issues). I think someone else basically said the same above, and this is my agreement. Without _someone(s)_ willing to manage this, it's never going to happen. On Mon, Sep 16, 2019, 9:20 AM @TiddlyTweeter, <[email protected]> wrote: > Mark S. > > Good practical post. > > My take on it: we need a consolidated search mechanism better honed to > finding things over the major source materials. > > TT > > On Monday, 16 September 2019 16:08:40 UTC+2, Mark S. wrote: >> >> Not that I would disagree about the documentation, but a small bit of >> your problem was Google search. It lead you to a static >> page that limited your other search options. In the upper right hand >> portion of the page it was tagged "TiddlyWiki on Node.js" >> which was meant to tip you off to the context. >> >> If you had gone to tiddlywiki.com, and typed "static" into the search, >> you would have seen the same tiddler listed. But you would also have >> seen hundreds of other possibilities including >> >> "How to export tiddlers" >> >> which is probably what you really wanted. >> >> When I'm looking for something about TiddlyWiki, and I think it's likely >> part of the core, my first stop is TiddlyWiki.com. >> >> If I'm looking for something about TiddlyWiki, and I think it's likely a >> 3rd party resource, my second stop is David Gifford's TiddlyWiki Toolmap >> <https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM#q=search>. >> >> If it was easy to do, I would modify "Generating Static Sites with >> TiddlyWiki" to include a link at the top to the exporting files option. >> However, all the documentation is done through GitHub and the methodology >> was changed without, ironically, a clear explanation >> of how to implement that change. Working this way is like building a ship >> in a bottle or mining a mountain with a tooth pick. >> >> Like others, I had started my own documentation for TW, but then realized >> that it would be an enormous amount of work, and >> would only have whatever visibility it happened to gain via Google. >> >> Good luck! >> >> On Monday, September 16, 2019 at 2:40:12 AM UTC-7, [email protected] >> wrote: >>> >>> Hi, >>> >>> I love TiddlyWiki but I hate its documentation. >>> >>> Let me give you an example. I want to export my tiddlywiki to a static >>> HTML web site, I spent an hour without success. >>> >>> Google gives me >>> >>> https://tiddlywiki.com/static/Generating%2520Static%2520Sites%2520with%2520TiddlyWiki.html >>> which tells me to use --rendertiddlers >>> >>> Note that if I click on a link to the command I go to >>> https://tiddlywiki.com/static/RenderTiddlersCommand.html >>> where it is said I should not use `--rendertiddlers` but `--render`. >>> If so, why don't the first page use `--render`? >>> >>> Whatever, what confuse me is how to use `--rendertiddlers`, I mean >>> where to type the code? >>> >>> It looks like an option of some command from my Unix point of view but >>> maybe there is some place in my tiddlywiki I should type that command which >>> starts with `--`. So I searched if I could change the type of a tiddler to >>> be executable, if there is a special tiddler hidden to run that command, >>> but without success. >>> >>> Then I looked for `commands` in TiddlyWiki and I see >>> "A command is one of the following words, written with a -- prefix and >>> used as a command-line option under Node.js," >>> >>> Argh, does it means I have to learn how to use Node.js? There is no >>> other way to export my pages? Hopefully there is a link to >>> "Using TiddlyWiki on Node.js". >>> >>> Here I find that indeed `--render` is an option of a command and not a >>> command itself and that the main command is `tiddlywiki`. >>> What the hell is the program tiddlywiki? For years I thought that >>> tiddlywiki was the empty.html file. >>> >>> So there is a tiddlywiki program. How do I download it? Is there is a >>> version for Linux? When I search in Debian packages I cannot find it. >>> >>> So I am stuck and I lost a lot of time. A good documentation would have >>> given me the command line from the beginning (at least in an exemple) and >>> of course it would have explain me how to download the tiddlywiki program. >>> Of course it would not suggest to use --rendertiddlers and somewhere else >>> says that it is deprecated. >>> >>> One example does not make a documentation to be bad, but I must say it >>> happened to me more than once that I had to find help on the Internet to >>> understand the documentation. That's a pity because TiddlyWiki is great. >>> >>> Olivier. >>> >>> ps: I have no idea why that mail changes the fonts from paragraph to >>> another. I guess it is a cursed day. >>> >> -- > 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 view this discussion on the web visit > https://groups.google.com/d/msgid/tiddlywiki/9e876507-16b6-4db9-a7d4-6da68e37b117%40googlegroups.com > <https://groups.google.com/d/msgid/tiddlywiki/9e876507-16b6-4db9-a7d4-6da68e37b117%40googlegroups.com?utm_medium=email&utm_source=footer> > . > -- 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 view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/CAJu7H0bbtee_a4mQRyUokjj9L_Ay7ppHbfJpMZtDLj7Ne82BUQ%40mail.gmail.com.
