Thanks everyone for the interesting thread — and particularly to Tony for stepping up to the gargantuan task of improving the documentation.
Tony’s original post makes a strong point very well: that the documentation would be more useful with more examples. It’s a great observation, because inserting examples into the existing docs can be done without necessarily having to do the kind of major refactorings that we’re already considering elsewhere. However, we’ve now gone on to cover much more familiar ground about the methods and tools that we should use. The first thing to note is that there is already a dedicated Google Group for discussing documentation improvements: https://groups.google.com/group/tiddlywikidocs <https://groups.google.com/group/tiddlywikidocs> In terms of spinning up a new wiki for working on the documentation, I’m not convinced that a single shared wiki will serve our purposes. What if, for example, while one person is working on reorganising content in one way somebody else wants to experiment with reorganising content in a different way. I think that what may be needed is more like the way Git works: the ability for any individual, or group of individuals, to fork the documentation and make their own changes to it for consideration for merging back. The easiest way to achieve that right now is to download tiddlywiki.com <http://tiddlywiki.com/> and upload it to tiddlyspot.com <http://tiddlyspot.com/>, and then make edits. It’s easy enough for me or another GitHubber to download the changes and compare them to the original. As Mat suggests, federation might offer more sophisticated ways of doing basically the same thing. Best wishes Jeremy > On 11 Dec 2017, at 11:51, @TiddlyTweeter <[email protected]> wrote: > > Ciao TonyM > > Your thread is causing me to think. > > I'm feeling its really beginning to register the problem with documentation > in a more move-on-able way. > > A few comments. To support your overview and mark a few places that maybe > don't get so easily noticed ... more sociology of behaviour than a solution > ... but I think worth pause--even though I'm partly repeating myself. > > 1 -- Users often GET documentation by asking questions on GG. --> The > "documentation" and solution finding are strongly inter-woven. > > 2 -- BECAUSE Google Groups loses its own history very quickly into a swamp of > "difficult-to-find" --> its very difficult for both BEGINNERS and folk not > reading everything everyday to find relevant answers already there. And even > if you are reading, if you are not cataloguing, its a struggle often to find > the "80% there already" solution. There is a big ORIENTATION problem from > lack of indices. > > 3 -- Since solution finding is a honing into PRECISE ANSWERS there is a > slight tension between Generalising and Specifics ... by which I mean unless > you read through several threads about, say, "timing" you may not be able to > bring a solution together without extra help. The current discussion of > __help needed in making a "n" minute timer macro__ > <https://groups.google.com/forum/#!topic/tiddlywiki/WuXWJPz68l0> is a good > example where there are lots of parts towards a solution that exist ... stuff > already made, discussions already done, new thoughts. Yet we all fumble > finding the relevant ones efficiently. > > I think an issue is definitely around documenting AND linking to some key > themes that will reduce the amount of repeated RE-CREATION OF 80% OF THE > WHEEL. > > Just thoughts. > > Best wishes > Josiah > > -- > 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] > <mailto:[email protected]>. > To post to this group, send email to [email protected] > <mailto:[email protected]>. > Visit this group at https://groups.google.com/group/tiddlywiki > <https://groups.google.com/group/tiddlywiki>. > To view this discussion on the web visit > https://groups.google.com/d/msgid/tiddlywiki/81f45cdb-aad2-450b-9b76-dec7f928c436%40googlegroups.com > > <https://groups.google.com/d/msgid/tiddlywiki/81f45cdb-aad2-450b-9b76-dec7f928c436%40googlegroups.com?utm_medium=email&utm_source=footer>. > For more options, visit https://groups.google.com/d/optout > <https://groups.google.com/d/optout>. -- 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/FA4592CC-D31E-4502-B43F-F6377F550DCD%40gmail.com. For more options, visit https://groups.google.com/d/optout.
