[IPython-dev] Link broken on github main-page

Fernando Perez fperez.net at gmail.com
Thu Feb 17 00:54:04 EST 2011


On Tue, Feb 15, 2011 at 10:38 AM, MinRK <benjaminrk at gmail.com> wrote:
> The link is broken because GitHub doesn't support using '.txt' as a reST
> extension, so it's interpreting the wrong text as a link.  We should
> probably rename README.txt to README.rst, and link to the new doc page.
> Is there a reason to *not* use .rst instead of .txt?

Well, docutils does suggest using txt as the reST extension, their
argument being that they ultimately are text files.  And on more
gui-oriented platforms, it was deemed as nicer for new users who could
double-click on a .txt file and get automatically a text editor
instead of a dialog about what application to use.  So historically,
we went with txt.

But I have no strong feelings on the matter, so if you guys prefer to
switch over to rst so the github setup is smoother, I won't oppose it
in any way.

Cheers,

f



More information about the IPython-dev mailing list