Re: [docs] [PATCH] migration-guide: add release notes for 4.0.16

[Michael Opdenacker <michael.opdenacker@bootlin.com>]

Hi Takayasu-San

Thanks for the review!

On 1/29/24 at 14:33, Takayasu Ito wrote:
> Hi Lee,
>
> I see that the Fixed and Security Fixes are listed in opposite places.


Ah right, the section titles are correct and well located, but their 
contents should be swapped.

>
> In the actual Security Fixes, cpio is listed above curl if it is 
> listed in ascending order.


Indeed, that would be nice to fix for consistency.

>
> In the actual Fixes section, "docs" and "documentation" are listed 
> differently for the same subject.
> I also need to be careful about the use of "manuals" and "documentation".


Right, I must confess I haven't paid too much attention to this so far, 
as nobody seemed to care.
Perhaps, we should enforce a "docs" prefix for all documentation 
contributions, and still mention the modified manual when only one 
manual is modified.

What do you think?

Anyway, I wouldn't rewrite the documentation commits we have so far as 
this is probably complicated, and as this has been happening for a long 
time.

Lee, do you have time for a quick V2? I can take care of it too...

Thanks again
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com