News Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

Hannes Magnusson:
New PHP.net designs floating around
September 06, 2013 @ 11:50:37

In a new post to his site Hannes Magnusson talks some about the current PHP documentation (and PHP.net site) formatting and how, while changes to it are quick, they should be instant. He suggests a path to get there and a new tool that could help.

Since 2008 there have been numerous efforts to create a new design for www.php.net, all of which have failed - so far. We've never come as close as two years ago, when the "beta mode" option was added to our website, but we never really got around to finish it. The "beta design" has even received a lot of makeover compared to what is "beta mode" now. To make things a little bit more awesome, there is also a new branch called "responsive" which has a lot of changes in it too, especially for manual pages. Hopefully, one day, we'll actually finish one of these and flip the switch forever.

While he's been a fan of the DocBook structure that's currently in use, he points out that learning the markup can be a hinderance to people contributing. His tool, PhD, does some custom parsing too adding additional complexity. To help, he's working on a new tool (WTFM) to use Markdown formatting instead of DocBook, a more common format.

0 comments voice your opinion now!
phpnet website design docbook markdown update

Link: http://bjori.blogspot.com/2013/09/new-phpnet-designs-floating-around.html

blog comments powered by Disqus

Similar Posts

Chris Jones' Blog: Available Now! Underground PHP & Oracle Manual, December 2008 Edition

Hannes Magnusson: New PHP.net designs floating around

Evert Pot: HTTP/1.1 just got a major update.

ProDevTips.com: Writing a CMS/Community with Smarty and the Zend Framework: Part 6

Andi Gutmans' Blog: Zend Framework invading Zend?


Community Events

Don't see your event here?
Let us know!


interview series voicesoftheelephpant example php7 laravel conference extension language api opinion laravel5 framework podcast introduction version library release community unittest

All content copyright, 2015 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework