Re: Specification live on git.php.net

On 30 Jul 2014, at 18:00, Sara Golemon <pollita@php.net> wrote: > http://hhvm.com/blog/5723 > > The wait is over! We’ve just pushed v1 of the PHP language spec to > the repo. The first thing you’ll notice is that it’s in Markdown. > Yeah, I know there was a slight lean towards ReStructuredText in my > little informal poll, but the guy working on massaging the spec out of > MSWord format (JoelM) had enough to deal with that I didn’t want to > sideline him too far with bike shedding over document format. I > suspect one of the first decisions we’ll make as a group is to pandoc > it into something else, and that’s fine. The important thing is to > have this starting point. I assume someone had mentioned this before but… does it have to be a single massive .md? Could each section have its own file? Just having one massive one doesn’t sound like a good idea to me from an editing standpoint, but we could always combine them together if we made a PDF official release for a particular version, for example. -- Andrea Faulds http://ajf.me/