Re: [PATCH] doc/rcu: Update LWN articles at the beginning

From: Bagas Sanjaya
Date: Sat Aug 20 2022 - 09:06:03 EST


On 8/20/22 15:32, Shao-Tse Hung wrote:
> This patch adds LWN articles about RCU APIs which were released in 2019.
> Also, HTTP URLs are replaced by HTTPS.
>

Please write patch description in imperative mood (say "Add 2019 edition
of RCU API documentation and use HTTPS links." instead).

> -| 1. What is RCU, Fundamentally? http://lwn.net/Articles/262464/
> -| 2. What is RCU? Part 2: Usage http://lwn.net/Articles/263130/
> -| 3. RCU part 3: the RCU API http://lwn.net/Articles/264090/
> -| 4. The RCU API, 2010 Edition http://lwn.net/Articles/418853/
> -| 2010 Big API Table http://lwn.net/Articles/419086/
> -| 5. The RCU API, 2014 Edition http://lwn.net/Articles/609904/
> -| 2014 Big API Table http://lwn.net/Articles/609973/
> +| 1. What is RCU, Fundamentally? https://lwn.net/Articles/262464/
> +| 2. What is RCU? Part 2: Usage https://lwn.net/Articles/263130/
> +| 3. RCU part 3: the RCU API https://lwn.net/Articles/264090/
> +| 4. The RCU API, 2010 Edition https://lwn.net/Articles/418853/
> +| 2010 Big API Table https://lwn.net/Articles/419086/
> +| 5. The RCU API, 2014 Edition https://lwn.net/Articles/609904/
> +| 2014 Big API Table https://lwn.net/Articles/609973/
> +| 6. The RCU API, 2019 Edition https://lwn.net/Articles/777036/
> +| 2019 Big API Table https://lwn.net/Articles/777165/
>

I don't think line blocks are necessary for lists. Instead, use nested
list. Why? Big API entry should be as sublist.

Thanks.

--
An old man doll... just what I always wanted! - Clara