On Wed, Feb 1, 2012 at 11:14 AM, Ulf Wendel <ulf.wen...@phpdoc.de> wrote:

>
> Am 01.02.2012 10:36, schrieb jpauli:
>
>> Well, we already have some changelog inside an extension documentation,
>> think like 
>> php.net/manual/en/curl.**constants.php<http://php.net/manual/en/curl.constants.php>
>> <http://php.net/manual/en/**curl.constants.php<http://php.net/manual/en/curl.constants.php>>
>> for example.
>>
>> I admit its not centralized.
>> Do you mean we shall add a special central changelog section summing up
>> the changes for every extension ?
>>
>
> Good morning Julien!
>
> Hannes has cited a commit of mine in which I update a "Change History"
> such as:
>
>  
> http://de.php.net/manual/en/**mysqlnd-ms.changes.php<http://de.php.net/manual/en/mysqlnd-ms.changes.php>
>  
> http://de.php.net/manual/en/**mysqlnd-qc.changes.php<http://de.php.net/manual/en/mysqlnd-qc.changes.php>
>
> These two "Change Histories"...
>
>  ... are for a two PECL extensions
>  ... try to be comprehensive summaries of changes
>  ... link to the main sections for details
>  ... accomplished by CHANGES files in the source tree
>  ... increase visibility and awareness
>  ... may not list all minor CHANGES file entries
>
> You are asking about, for example, http://php.net/manual/en/curl.**
> constants.php <http://php.net/manual/en/curl.constants.php> . This also
> exists in the above named PECL extensions documentation for constants,
> configuration directives, functions and so forth. This is what I refer to
> as "... link to main sections for details" above. Naming changes in such
> constants, ... lists is good, is proven, is useful... - please let's
> continue with it.
>
> However, I felt that there was room for something in-between change
> details scattered in the main sections, a not so much visible
> CHANGES/NEWS/... file in the source tree and upgrade guidelines. I called
> this something "Change History" (I'm open to rename it).
>
> As I understand it, Hannes suggests to have a "Change History" or "Change
> Log" for every extension as the necessary change summary information is
> already in the central NEWS file. Similar to my PECL extension case.
>
> I do like that proposal. Though, one should be aware of the additional
> work. I would have had appreciated to find a template in the manual that I
> could have copied for my PECL extension case.
>
> Ulf
>

That makes things clearer to me :)

So, yes Hannes, I do like the idea :) but like Ulf said, we should compute
the additional work needed to get those new chapters inside each supported
extension. We support *lots* of PECL extensions inside the main php-doc
tree (http://www.php.net/manual/en/extensions.alphabetical.php) , so that
would represent a lot of work.

Julien.P

Reply via email to