Comments on: Thanks for your thoughts on improving PEAR http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/ The weblog of Joshua Eichorn, AJAX, PHP and Open Source Sun, 12 Oct 2008 01:10:54 +0000 http://wordpress.org/?v=2.6.2 By: Markus Wolff http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/#comment-192703 Markus Wolff Wed, 09 May 2007 10:59:57 +0000 http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/#comment-192703 I'm sure this came up already, but just in case, and be it only to add one more voice to the count, I'm all for providing a Wiki for package documentation. DocBook is all good and well from an academic point of view, but it has always hindered writing end-user docs for many, many packages and many people either don't know how or are simply unwilling to use it. A wiki would be a much easier way to add docs, IMHO, leading to more docs being written. Granted, you can't transform Wiki markup to other output formats as easily as with DocBook, but honestly, how many people need to do that? Personally, I've never touched any other documentation format than HTML and I don't know of anyone who did. Should some people insist on having other output formats, I am pretty sure a converter can be written if you really, really want/need one. I’m sure this came up already, but just in case, and be it only to add one more voice to the count, I’m all for providing a Wiki for package documentation. DocBook is all good and well from an academic point of view, but it has always hindered writing end-user docs for many, many packages and many people either don’t know how or are simply unwilling to use it.

A wiki would be a much easier way to add docs, IMHO, leading to more docs being written. Granted, you can’t transform Wiki markup to other output formats as easily as with DocBook, but honestly, how many people need to do that? Personally, I’ve never touched any other documentation format than HTML and I don’t know of anyone who did.

Should some people insist on having other output formats, I am pretty sure a converter can be written if you really, really want/need one.

]]> By: developercast.com » Joshua Eichorn’s Blog: Thanks for your thoughts on improving PEAR http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/#comment-192435 developercast.com » Joshua Eichorn’s Blog: Thanks for your thoughts on improving PEAR Tue, 08 May 2007 21:03:46 +0000 http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/#comment-192435 [...] up from a previous post of his that got lots of great feedback, Joshua Eichorn has posted his own thanks, not only for the responses to his own thoughts but to the PEAR community as a whole. [...] [...] up from a previous post of his that got lots of great feedback, Joshua Eichorn has posted his own thanks, not only for the responses to his own thoughts but to the PEAR community as a whole. [...]

]]> By: PHPDeveloper.org http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/#comment-192409 PHPDeveloper.org Tue, 08 May 2007 18:50:57 +0000 http://blog.joshuaeichorn.com/archives/2007/05/08/thanks-for-your-thoughts-on-improving-pear/#comment-192409 <strong>Joshua Eichorn's Blog: Thanks for your thoughts on improving PEAR...</strong> ... Joshua Eichorn’s Blog: Thanks for your thoughts on improving PEAR…

…

]]>