[Numpy-discussion] docs.scipy.org -- new site for the documentation marathon
Sun Oct 26 11:41:28 CDT 2008
On Sun, Oct 26, 2008 at 10:13 AM, Pauli Virtanen <firstname.lastname@example.org> wrote:
> Now, the role of docs.scipy.org warrants discussion, because on the one
> hand, the domain "docs.scipy.org" looks very official, and on the other
> hand, "scipy.org/Documentation" claims to be the place for official
> documentation. What do you think: should we use the current front page
> of docs.scipy.org, shifting the focus and entry point of documentation
> to the Sphinx-generated pages, or still keep the focus on the Moin wiki
> at scipy.org?
> I'd like to see a move towards a full dedicated documentation site -- I
> believe using Sphinx is the way to go in the future, and documentation
> generated by it does have a reassuring and clear visual appearance.
> Also, making the Sphinx documentation more prominent could help people
> to focus documentation efforts, and write more of it :)
Great work, I definitely like the look of the Sphinx documentation.
As a concrete example of your question, I've been working on some
scipy.sparse documentation , and it seems like it will be fairly
lengthy when completed. Would it be appropriate to merge it into the
Sphinx documentation for scipy.sparse , or should the Sphinx docs
be more concise?
Nathan Bell email@example.com
More information about the Numpy-discussion