Optionally serve ./docs from the web gateway.

[nejucomo]

I was just updating ticket #1659 which is about the lack of documentation in python installations of LAFS.

I started looking into the "standard way" to bundle documentation into python package installs, and it seems like there is none! :-(

However, it occurred to me that it would be convenient for many users to have the docs served from gateway. It could even render .rst files to HTML.

[daira]

Replying to nejucomo:

However, it occurred to me that it would be convenient for many users to have the docs served from gateway. It could even render .rst files to HTML.

It could, but is this worth the packaging cost of rst2html?

(Without rendering as HTML, you wouldn't have links, so it would be strictly less useful than browsing ​https://github.com/tahoe-lafs/tahoe-lafs/tree/master/docs or ​https://tahoe-lafs.org/trac/tahoe-lafs/browser/trunk/docs.)

[daira]

Well, perhaps not strictly less useful if you're offline.

[daira]

Perhaps add a script or make offline-docs Makefile target that assumes rst2html is installed, and dumps an HTML copy of the docs to BASEDIR/public_html?

[daira]

Replying to daira:

Perhaps add a script or make offline-docs Makefile target that assumes rst2html is installed, and dumps an HTML copy of the docs to BASEDIR/public_html?

Ah, but then the docs would be tied to the basedir and not to the version of Tahoe-LAFS being run as the gateway, so that wouldn't satisfy the requirements of #1659.