Re: Extension changelogs

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> 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-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 . 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