Re: pecl_http docs
| From: | Christoph Becker | 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