Re: Tutorial - request for feedback
| From: | Philip Olson | Date: | Mon, 16 Jun 2014 18:48:11 +0000 |
| Subject: | Re: Tutorial - request for feedback | ||
| References: | 1 2 3 4 5 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969384998@lists.php.net to get a copy of this message | ||
On Jun 16, 2014, at 8:27 AM, Maciej Sobaczewski <sobak@php.net> wrote:
>> Maybe if wiki can be updated so it understands markdown we can revist
>> this? Although I certainly don't see that happening in the near
>> future.
>>
>> Thanks, Chris
>>
>
> There are some plugins and one is quite promising but currently it
> doesn't seem to be stable enough :( I'd love to see such change but it's not so
> easy to do.
It’s great to see you merging and expanding the two HOWTO documents,
something that’s been needed for several years now! Excellent work :)
As for the markup discussion, why not DocBook? Basically, replace this:
http://doc.php.net/dochowto/
Originally (IIRC) the idea was to use the wiki as a draft that’d later
end up as a dochowto rewrite in DocBook, but of course that plan didn’t
work out. DocBook is more complicated (especially for developing a draft)
but it’d match the PHP documentation.
Just a thought, I’d rather not interfere and stall the work here but
figured it’s worth mentioning.
Regards,
Philip