Re: pecl_http docs

From: Date: Fri, 10 Jun 2016 14:21:05 +0000
Subject: Re: pecl_http docs
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969386156@lists.php.net to get a copy of this message
Resending to the list, because the original message seems to have been swallowed. Peter Cowburn wrote: > On 7 June 2016 at 15:05, Christoph Becker <cmbecker69@gmx.de> wrote: > >> On 21.01.2016 at 17:26, Peter Cowburn wrote: >> >>> I have removed the documentation for the pecl_http extension from the >>> English branch upon the maintainer's request. Our manual only documented >>> v1, which caused lots of confusion given that the v2 (and now v3) API is >>> very different. >>> >>> Good API documentation of the current versions of the extension is >>> maintained by the extension author on his site [1], which is easier for >> him >>> to maintain since it uses Markdown and he has an aversion to DocBook! >>> >>> In due course, I will go through the translations and tidy up. >>> >>> P.S. If there is any strong dissent, please make yourselves known. >>> >>> [1] https://mdref.m6w6.name/http >> >> It seems there is still some confusion about the missing http >> documentation (see <https://bugs.php.net/72355>, for >> instance). What >> about re-adding a single page (reference/http/book.xml) with a short >> explanation that the documentation is now available on >> <https://mdref.m6w6.name/http>? Not sure, if that >> would be of much >> help, but it seems to be better than the current state. > > I don't think that would help at all and would rather have nothing, letting > the search engines do the hard work of pointing people to the correct place. > > If we were to do this for pecl_http, then why not do it for all externally > documented extensions? Okay. :) -- Christoph M. Becker

« previous php.doc (#969386156) next »