Re: [PATCH v2] docs: document linked lists

[Bagas Sanjaya <bagasdotme@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 1292 bytes --]

On Wed, Jul 02, 2025 at 10:24:47PM +0200, Nicolas Frattaroli wrote:
> +In State 2, we've added Grock after the list head::
> +
> +         .--------------------.
> +         v                    |
> +    .--------.     .-------.  |
> +    | clowns |---->| Grock |--'
> +    '--------'     '-------'

Looks like the corners are a bit imbalanced (single quotes are taller than
dots). What about using plus instead? Like:

---- >8 ----
diff --git a/Documentation/core-api/list.rst b/Documentation/core-api/list.rst
index b0586056abb04d..bf92f44d7b2d06 100644
--- a/Documentation/core-api/list.rst
+++ b/Documentation/core-api/list.rst
@@ -148,11 +148,11 @@ clarity.
 
 In State 2, we've added Grock after the list head::
 
-         .--------------------.
+         +--------------------+
          v                    |
-    .--------.     .-------.  |
-    | clowns |---->| Grock |--'
-    '--------'     '-------'
+    +--------+     +-------+  |
+    | clowns |---->| Grock |--+
+    +--------+     +-------+
 
 This diagram shows the "clowns" node pointing at a new node labeled "Grock".
 The Grock node is pointing back at the "clowns" node.

The docs wording looks good, though.

Thanks.

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]