Re: Getting more people involved.. bye bye Docbook
| From: | Hannes Magnusson | Date: | Sat, 10 Aug 2013 19:09:15 +0000 |
| Subject: | Re: Getting more people involved.. bye bye Docbook | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969384554@lists.php.net to get a copy of this message | ||
On Sat, Aug 10, 2013 at 4:24 AM, Davide Pastore <pasdavide@gmail.com> wrote:
>
> Il 10/08/2013 7.34, Hannes Magnusson ha scritto:
>
> What do you guys think? :)
>
> It's a great idea! If it can help you, you should also take a look at this page.
> Do you think that a validator for the markdown text is as efficient as that for xml?
The onlything we need to validate is our ordering-consistency style:
- Description
- Parameters
- Return values
- Changelog
- Examples
- Notes
- See alos
I don't care if <simpara> or <para> is used in a <varlistentry>. Noone cares.
I don't think we need any complicated validation.
Especially since the rendering of a page should be instant, you can
hit refresh to see if it looks pretty. Without caring if you should
have a different structural element.
-Hannes