Re: Specification live on git.php.net
| From: | Hannes Magnusson | Date: | Wed, 30 Jul 2014 19:35:13 +0000 |
| Subject: | Re: Specification live on git.php.net | ||
| References: | 1 2 3 4 5 | Groups: | php.standards |
| Request: | Send a blank email to standards-+get-137@lists.php.net to get a copy of this message | ||
On Wed, Jul 30, 2014 at 10:53 AM, Florian Anderiasch <ml@anderiasch.de> wrote:
> 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.
Then... fix the header to include a space after # and call it GFM. Or
maybe Joel can chime in with what his goal was?
If it turns out later we need something more/else then.. we upgrade. No biggie.
As a side note:
I haven't seen "MMD" before, but that looks awesome and looks like it
includes all that phpdoc needs! :D
-Hannes