Hi Jeremy On Thursday, 24 September 2015 13:44:04 UTC+2, Jeremy Ruston wrote: > > Hi Matabele > > The process of exporting a tiddler to a .tid file, then attaching this >> file to a post on this forum is fairly straightforward. >> > > Another possibility is to use the "export all" button in the sidebar tools > tab to export a JSON file of just the changed tiddlers. >
That makes things easier -- it had escaped my notice that once the docs had been placed into a plugin, an 'export all' would export only modified documentation. Looks to me that the TW5-docs plugin should, therefore, be broken into >> several sections -- one for each TW5-docs moderator. >> > > Things get a bit easier if we can assume that moderators are working in > GitHub, even if the contributors aren't. > Again -- this streamlines the merge process. With these two modifications, the process should be fairly simple for contributors: A contributor: (a) downloads and saves a copy of the latest TW5-docs (b) modifies (or creates) the relevant tiddlers (c) exports the modified tiddlers in JSON format (with 'Export all tiddlers' button) (d) attaches this JSON file to a post (explaining the reason for the changes) in the appropriate thread of the TiddlyWik-Docs forum. And the moderators picks up the process from there. It seems that downloading JSON files from a Google group is easier for a moderator than visiting a list of blogspot wikis and, attaching a JSON file to a post is easier for a contributor than creating and updating a blogspot wiki. This also provides a forum for contributors to discuss their documentation modifications (with moderators and other contributors) before they post to the pinned threads. regards On Tuesday, 15 September 2015 18:18:42 UTC+2, Jeremy Ruston wrote: >>> >>> Following up some recent discussions about making it easier for people >>> to contribute improvements to the documentation on tiddlywiki.com, I've >>> been experimenting with a new edition for documentation contributors: >>> >>> http://tiddlywiki.com/prerelease/editions/tw5.com-docs/ >>> >>> It's based on a new plugin $:/plugins/tiddlywiki/tw5.com-docs that >>> contains all the documentation tiddlers from tiddlywiki.com. The >>> advantage is that it's easier to tell which tiddlers you've modified, and >>> to revert to the original. >>> >>> The idea is that a would-be contributor would clone this edition to >>> TiddlySpot (step-by-step instructions forthcoming), and then make their >>> changes, saving them back to TiddlySpot. I, or anyone else, can fairly >>> easily then pick up the wiki and extract the changed tiddlers into a pull >>> request. >>> >>> One shortcoming at the moment is that TiddlyWiki gives a warning each >>> time you modify a shadow tiddler. >>> >>> A desirable feature is the ability to see line-by-line diffs for the >>> changes, and perhaps to be able to easily export a JSON file of the changed >>> tiddlers. >>> >>> Anyhow, feedback and questions are welcome, >>> >>> Best wishes >>> >>> Jeremy. >>> >>> >>> -- >>> Jeremy Ruston >>> mailto:jeremy...@gmail.com >>> >> > > > -- > Jeremy Ruston > mailto:jeremy...@gmail.com <javascript:> > -- 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 tiddlywiki+unsubscr...@googlegroups.com. To post to this group, send email to tiddlywiki@googlegroups.com. 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/42e098ad-3da3-4eb4-9b7f-91289dd37bed%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
