[ 
https://issues.apache.org/jira/browse/CXF-8819?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17692846#comment-17692846
 ] 

Philippe Cloutier commented on CXF-8819:
----------------------------------------

Thank you Andriy, that's a pretty good point.

Unfortunately, I'm afraid the pages you refer to misuse the term "changelog", 
which is not synonymous with "release notes". A changelog "is a log or record 
of all notable changes made to a project", not just those made in a given 
release. Therefore, ideally, a project which builds 1 software product would 
have 1 changelog and _x_ release note documents, where _x_ is the number of 
releases of the product.

The documents you mention are titled "release notes", yet each refers to 
another document called "release notes", which doesn't make sense. I recommend 
to retitle the _Changelog_ section "Changes".

 

I should mention Apache publishes [CXF migration 
guides|https://cxf.apache.org/docs/migration-guides.html].

> No changelog
> ------------
>
>                 Key: CXF-8819
>                 URL: https://issues.apache.org/jira/browse/CXF-8819
>             Project: CXF
>          Issue Type: Wish
>          Components: Documentation
>            Reporter: Philippe Cloutier
>            Priority: Minor
>         Attachments: image-2023-02-13-18-15-37-633.png
>
>
> As far as I can see, no changelog of Apache CXF exists. There are individual 
> release notes, but not even direct links to each.
> If that is the case, please offer one, and if one already exists, please 
> consider this as a request to make it more prominent on the website.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to