I think Hans' observation that the best docs are written by newcomers who learning their way about, with over the shoulder corrections and refinements by those more experienced, is spot on.
> The barrier to contributing to the docs. is knowing how to use bzr to > push to the trunk, which means setting up a ssh key for your launchpad > account. If you can do that you can edit the docs. in > Leo .../leo/doc/LeoDocs.leo and commit and push the changes yourself. For me, installing bazaar, learning some basics, and setting up an launchpad ssh key was easyish, but not easy. I think if I hadn't already had a year or so of using tortoise-svn and prior experience with ssh under my belt it would have been difficult. So yes, I'd still call this a barrier. I agree that the existing wiki might be better turned off, saving a number of pages which are still germane for placement elsewhere. 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. It doesn't operate this way now, but at one time effbot.org would accept edits from anybody, but not publish the edits until they'd been accepted. On submission of an edit the web host would generate a unified diff file and fire it off it to the maintainer (Fredrick Lundh). If Fredrick liked the edit he'd patch and save, and that would be the new web page. I always thought this a very elegant solution and wished it showed up in the tools I've used for my websites. How difficult would it be to have DokuWiki (or MoinMoin or ...) push edits to a leo-editor-website bzr banch that has standing merge to trunk request? And how much work would it be for members of leo-editor team (or leo-website team) to accept/reject these pushes? -- -matt -- You received this message because you are subscribed to the Google Groups "leo-editor" group. 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.
