[IPython-dev] Website

Thomas Kluyver takowl at gmail.com
Wed Jun 1 05:26:54 EDT 2011

On 1 June 2011 04:33, Brian Granger <ellisonbg at gmail.com> wrote:

> * Moving away from ipython.scipy.org to simply ipython.org

This makes sense. I understand we can easily create a CNAME if we're hosting
the site using Github pages.

> * Using sphinx for the entire site as matplotlib does.

This I'm less sure about. Sphinx is great for documentation, but I don't
think it works so well for a whole website:

* The layout is really geared towards writing documentation.
* With so many projects now using Sphinx for docs, people instantly
recognise the layout and think 'docs'. Whenever I go to matplotlib's
website, I have this feeling that I've missed the homepage somewhere and
skipped straight to the docs.
* We'll want to update parts of the website fairly often. If every small
change requires the site to be checked out as source, rebuilt by Sphinx
(with all its dependencies) and reuploaded, the site's just going to get out
of date.

> * Moving the wiki stuff over to github.

Again, this makes sense. I take it we're talking about turning on the wiki
feature in Github, rather than just moving the content into github pages?

I think the key thing is to work out how we want to divide content between:
- Documentation
- A wiki
- A landing page (or a small collection of pages)

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20110601/b3022968/attachment.html>

More information about the IPython-dev mailing list