I think putting it as a special branch of github is a good idea. Anything where other people can add there own stuff to the docs is cool.

another thing we might want is to be able to let people comment on a particular section. eg. suggested changes/queries. It might also move some of the newbie questions away from the mailing list

there's just the small matter of cutting & pasting everything from the current docs...

On 10/04/2012 20:01, Lane Schwartz wrote:
Barry,

What about making a special branch in the git repo for documentation?

That way anyone with access to the git repo could easily add to the documentation as needed.

The nightly build could just check out that branch and compile it from whatever format you want people to edit it in (presumably latex or possibly docbook) into pdf (and possibly also html).

Cheers,
Lane


On Tue, Apr 10, 2012 at 8:51 AM, Barry Haddow <[email protected] <mailto:[email protected]>> 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

    --
    The University of Edinburgh is a charitable body, registered in
    Scotland, with registration number SC005336.

    _______________________________________________
    Moses-support mailing list
    [email protected] <mailto:[email protected]>
    http://mailman.mit.edu/mailman/listinfo/moses-support




--
When a place gets crowded enough to require ID's, social collapse is not
far away.  It is time to go elsewhere.  The best thing about space travel
is that it made it possible to go elsewhere.
                -- R.A. Heinlein, "Time Enough For Love"


_______________________________________________
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

Reply via email to