Re: Specification live on git.php.net
| From: | Florian Anderiasch | Date: | Wed, 30 Jul 2014 17:53:18 +0000 |
| Subject: | Re: Specification live on git.php.net | ||
| References: | 1 2 3 4 | Groups: | php.standards |
| Request: | Send a blank email to standards-+get-133@lists.php.net to get a copy of this message | ||
First roadblock for the FORMATTING.md, which flavor of markdown is
actually sensible to support?
From the last minutes reading it, it seems to be pretty vanilla, with a
few exceptions.
- uses tables
- the github/markdown gem does not seem to parse
#Intro, it would
expect # Intro although it renders just fine on [1]
So these are the implementations I can think of form the top of my head:
- Gruber's original Markdown [2]
- GitHub flavored markdown [3]
- pandoc markdown [4]
- Multimarkdown [5]
Tables are kind of neat, GFM is is kind of common these days, and MMD is
overkill, imho.
Sorry to whip out the "coding standards" bat, but I think if the
infrastructure is settled at the start, it's easier for everybody
involved :)
~Florian
[1]: https://github.com/php/php-spec/blob/master/spec/php-spec-draft.md
[2]: http://daringfireball.net/projects/markdown
[3]: https://help.github.com/articles/github-flavored-markdown
[4]: http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html
[5]: http://fletcherpenney.net/multimarkdown/