Hi, if we want regular folks to contribute to the documentation, then SVN/Latex is not the best choice...
I see some advantages about enabling comments to each page. This is very helpful for some documentation that I frequently use (e.g., PHP). -phi On Wed, Apr 11, 2012 at 2:24 AM, Barry Haddow <[email protected]> wrote: > Hi Folks > > It looks like there's strong support for documentation in Latex, hosted in > github, with website generated from it when you commit. Daniel's suggestion of > using github/gollum/mediawiki is also something well worth investigating. > > Whilst we investigate conversion options though, I need to revamp the existing > documentation, doing some reorganising and pruning, and improving the 'getting > started' guides. For project-related reasons this has to be done for the end > of the month, and also there's been a lot of recent changes which have not > been fully reflected in the documentation. > > To this end, I've created a fresh version of the Moses documentation in the > usual place, and backed up the old one to http://www.statmt.org/moses.old/. > Ideally, you shouldn't notice any difference in the new Moses documentation > (until I start making changes) but please let me know if there are any broken > links or missing pages. > > I've also severed the link between moses and mosesdev, so now if you want to > edit the Mose documentation, use the link at the bottom right, with the same > password as before. mosesdev is still there, but it will be decommissioned. > (If you don't know what mosesdev is, then just ignore this paragraph), > > cheers - Barry > > On Tuesday 10 April 2012 13:51:34 Barry Haddow wrote: >> Hi Folks >> >> I'm going to be spending some time over the next couple of weeks improving >> the Moses documentation (http://www.statmt.org/moses/), with the aim of >> making the Moses manual more up-to-date and useful. >> >> I'd therefore like to know if anyone has any comments or corrections for >> the existing documentation, or suggestions on how to improve it. If you >> do, then please either mail me directly, or mail this list if you think >> it's more approriate. >> >> I'd also be interested to hear your suggestions as to how to enable more >> people to contribute to the documentation. The Moses documentation is >> currently hosted on PmWiki, with password-enabled editing, and the manual >> is produced nightly by converting the wiki to latex and compiling it to >> pdf. However there might be other systems which would make it easier for >> anyone to sign up and contribute, >> >> thanks for your help! >> >> cheers - Barry >> > > -- > Barry Haddow > University of Edinburgh > +44 (0) 131 651 3173 > > -- > The University of Edinburgh is a charitable body, registered in > Scotland, with registration number SC005336. > > _______________________________________________ > Moses-support mailing list > [email protected] > http://mailman.mit.edu/mailman/listinfo/moses-support _______________________________________________ Moses-support mailing list [email protected] http://mailman.mit.edu/mailman/listinfo/moses-support
