[Scons-dev] README in repository

Russel Winder russel at winder.org.uk
Tue Oct 9 12:22:17 EDT 2012


I think we have to take a vote on whether to switch the read me file at
the top of the repository hierarchy from plain text to

a) ReStructured Text, README.rst
b) Markdown, README.md or README.markdown

I have a slight preference fro Markdown due to the way it handles header
markup compared to ReStructured Text. On the other hand Markdown is very
Ruby, GitHub, whilst ReStructured Text is very Python.

Why the change? So that the read me file look reasonable on the
BitBucket page.

I can do the markup once a decision is made so there is no need for
anything other than a decision.

--
Russel.
=============================================================================
Dr Russel Winder t: +44 20 7585 2200 voip: sip:russel.winder at ekiga.net
41 Buckmaster Road m: +44 7770 465 077 xmpp: russel at winder.org.uk
London SW11 1EN, UK w: www.russel.org.uk skype: russel_winder
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
Url : <http://two.pairlist.net/pipermail/scons-dev/attachments/20121009/790f0ebd/attachment.pgp>


More information about the Scons-dev mailing list