On Monday, January 9, 2012 12:26:42 PM UTC+7, Matt Wilkie wrote:
>
> I'm not sure that using a newer shinier wiki platform in it's stead would 
> get at what I see as the deeper cause: the user contributed docs being in a 
> separate world from where the developers live.
>
Perhaps I wasn't clear enough; what I was proposing would eliminate this 
separation. 

1. The developer's Leo files push plaintext out via @ <files>, most likely 
shadow? They could even have rst markup if/where that's important.

2. They get served up, directly and as-is, by DokuWiki - plaintext files 
**are** its native datastore. In effect the @files are available on the web 
for you, me and Joe Blow to edit - subject of course to whatever 
open/secure balance the developers desire.

3. Periodically the updated text is compared with the "canonical" original, 
most likely via the developers' preferred diffing tools, however DokuWiki 
also has its own history/scs built-in (to use or ignore).

4. The developers merge those edits they approve back into their canonical 
.leo files, then push these back out to the wiki's filesystem - easy to 
reset the DW-internal history at that point as well, start off with a blank 
set each round.

5. Rinse cycle repeat. I think the most frequent cycle if there were a lot 
of doc improvements by the community would be monthly, otherwise quarterly 
would probably suffice. I'd be willing to act as 
sysadmin/liason/coordinator in keeping things on the wiki in order, but of 
course won't be able to technically vet content changes beyond my pay 
grade. . .

I'd also, alternatively, be willing to climb the bizarre learning curve if 
I had a little handholding to make sure I wasn't messing up anything 
important, but I honestly think making it quick and easy for any Leo user 
spotting a docs error to quickly fix it themselves, would be a good thing.

Not to mention having everything in one place for searching - right now 
there's a learning curve to getting familiar with how the docs are 
structured, which IMO shouldn't be there, especially for the stuff 
important for newcomers.


-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/leo-editor/-/nk7HoCPqxDcJ.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/leo-editor?hl=en.

Reply via email to