[IronPython] Building IronPython/IronRuby for Mono?

[TP]

On Tue, Mar 22, 2011 at 8:34 AM, Jeff Hardy <jdhardy at gmail.com> wrote:
> On Tue, Mar 22, 2011 at 9:29 AM, Brian Curtin <brian.curtin at gmail.com> wrote:
>> docs.ironpython.net?
>> Might I suggest sphinx-quickstart as the first command to run.
>
> That's kinda what I'm leaning towards, preferably hosted on
> readthedocs.com. Most of the docs are already ReST so using sphinx
> should be easy. As always, it's just a matter of time, and after
> watching Jacob Kaplan-Moss at PyCon, I feel really bad about the state
> of our docs right now.

Since you're already hosted on github, you can also just use their
gh-pages feature to host the documentation. See
http://pages.github.com/ for more information. In particular note:

    "As of December 27, 2009, you can completely opt-out of Jekyll
    processing by creating a file named .nojekyll in the root of your
    pages repo and pushing that to GitHub. This should only be necessary
    if your site uses directories that begin with an underscore, as
    Jekyll sees these as special dirs and does not copy them to the
    final destination."

You'll probably have to do this since by default, Sphinx *does*
generate directories that start with an underscore. Once you create a
gh-pages branch and push your HTML to it, the documentation will show
up at http://IronLanguages.github.com/main/.

          -- TP