Refried "SPAM" for GSoC 2016
The classic article on writing GSoC proposals, updated a bit for 2016, refactored for Moin (does Moin do ReST? the biggest annoyance was repeating links in several places) and moved to the Wiki.
http://wiki.list.org/DEV/SPAM, reviews welcome. Or just fix what's broke. ;-)
Steve
On 02/09/2016 11:31 AM, Stephen J. Turnbull wrote:
(does Moin do ReST? the biggest annoyance was repeating links in several places)
Yes it does.
You can specify that the markup for an entire page is ReST by putting a
#format rst
line at the top of the page. You can embed ReST sections with the notation
{{{#!rst ReST markup ... }}}
See <http://wiki.list.org/HelpOnParsers> and <http://wiki.list.org/HelpOnParsers/ReStructuredText>
-- Mark Sapiro <mark@msapiro.net> The highway is for gamblers, San Francisco Bay Area, California better use your sense - B. Dylan
Mark Sapiro writes:
On 02/09/2016 11:31 AM, Stephen J. Turnbull wrote:
(does Moin do ReST? the biggest annoyance was repeating links in several places)
Yes it does.
Thanks for the confirmation! I should have guessed that (and figured out where to look for docs, it's in the editor's hints :-).
The more important questions are "would anybody be hindered in editing pages if some pages were in ReST syntax and others in Moin?" and "is there a significant constituency for ReST?"
I do think ReST is both more readable and more powerful, especially at the scale of something like DEV/SPAM. But the difference is negligible for me for all other pages where I've looked at source (so far).
On Feb 10, 2016, at 11:45 AM, Stephen J. Turnbull wrote:
The more important questions are "would anybody be hindered in editing pages if some pages were in ReST syntax and others in Moin?" and "is there a significant constituency for ReST?"
I do think ReST is both more readable and more powerful, especially at the scale of something like DEV/SPAM. But the difference is negligible for me for all other pages where I've looked at source (so far).
I also like ReST format, but I might be biased because all the doctests are written in it. ;)
It doesn't bother me that wiki pages are in a mix. Use whatever feels most useful.
Cheers, -Barry
participants (3)
-
Barry Warsaw -
Mark Sapiro -
Stephen J. Turnbull