[Scons-dev] README in repository
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.win...@ekiga.net 41 Buckmaster Roadm: +44 7770 465 077 xmpp: rus...@winder.org.uk London SW11 1EN, UK w: www.russel.org.uk skype: russel_winder signature.asc Description: This is a digitally signed message part ___ Scons-dev mailing list Scons-dev@scons.org http://two.pairlist.net/mailman/listinfo/scons-dev
Re: [Scons-dev] README in repository
On a related note, we need to update the information on setting environment variables for testing. I am not sure which shell uses "setenv MYSCONS=`pwd`" format but not any of the ones I use. From: scons-dev-boun...@scons.org [scons-dev-boun...@scons.org] on behalf of Russel Winder [rus...@winder.org.uk] Sent: Tuesday, October 09, 2012 9:22 AM To: SCons_Developers Subject: [Scons-dev] README in repository 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.win...@ekiga.net 41 Buckmaster Roadm: +44 7770 465 077 xmpp: rus...@winder.org.uk London SW11 1EN, UK w: www.russel.org.uk skype: russel_winder ___ Scons-dev mailing list Scons-dev@scons.org http://two.pairlist.net/mailman/listinfo/scons-dev
Re: [Scons-dev] README in repository
Russel, On Oct 9, 2012, at 9:22 AM, Russel Winder wrote: > 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. I vote for .rst (mainly because I'm already using it on a number of other projects and it's python'y) -Bill ___ Scons-dev mailing list Scons-dev@scons.org http://two.pairlist.net/mailman/listinfo/scons-dev
Re: [Scons-dev] README in repository
Hi guys, On 09.10.2012 19:39, William Deegan wrote: Russel, On Oct 9, 2012, at 9:22 AM, Russel Winder wrote: 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. I vote for .rst (mainly because I'm already using it on a number of other projects and it's python'y) +1 from me for reST (*.rst). I use it quite a lot recently...at home as well as at work. Dirk -Bill ___ Scons-dev mailing list Scons-dev@scons.org http://two.pairlist.net/mailman/listinfo/scons-dev ___ Scons-dev mailing list Scons-dev@scons.org http://two.pairlist.net/mailman/listinfo/scons-dev