website update user's guide

Author: ilg-ul

website/docs/developer/_project/_test-details.mdx

@@ -19,13 +19,24 @@ test 1
 1: Working Directory: /Users/ilg/MyProjects/micro-os-plus.github/xPacks/utils-lists-xpack.git/tests/build/native-cmake-sys-debug/platform-bin
 1: Test timeout computed to be: 10000000
 1: micro_os_plus::trace::initialize()
-1: Mary
-1: Bob
-1: Sally
 1:
-1: Mary
-1: Sally
-1/2 Test #1: sample-test ......................   Passed    0.24 sec
+1: All kids:
+1: - Mary
+1: - Bob
+1: - Sally
+1: - Doug
+1:
+1: Bob is gone...
+1: - Mary
+1: - Sally
+1: - Doug
+1:
+1: School kids:
+1: - Sally
+1: - Doug
+1:
+1: Done.
+1/2 Test #1: sample-test ......................   Passed    0.00 sec
 ```
 
 ### unit-test
@@ -34,7 +45,7 @@ The [unit-test.cpp](https://github.com/micro-os-plus/utils-lists-xpack/blob/xpac
 file is an exhaustive test trying to validate that all the library
 functions work as expected. It uses the
 [µTest++](https://github.com/micro-os-plus/micro-test-plus-xpack)
-framework.
+testing framework.
 
 A typical run looks like:
 

website/docs/getting-started/_project/_overview.mdx

@@ -4,7 +4,7 @@
 ## Overview
 
 The **µOS++ Intrusive Lists** project is a C++ source code library
-that implements the **µOS++ intrusive double linked lists**.
+that implements the **µOS++ intrusive doubly linked lists**.
 These are special lists that avoid dynamic memory allocations by
 storing the links inside the list elements. This is particularly
 useful in embedded systems.

website/docs/user/_project/_content.mdx

@@ -9,6 +9,16 @@ nodes (the objects used to store pairs of links), which can pose challenges
 on embedded systems. Consequently, it is advisable to avoid such allocations
 where possible, particularly at the system level.
 
+## Regular lists
+
+A standard doubly linked list comprises a pair of pointers (represented
+by the red object) and a set of additional pointers that connect to
+each other as well as to the payload (depicted by the yellow objects).
+
+Whenever a payload is added to the list, the corresponding object must
+be acquired from an allocator. Similarly, whenever an object is removed
+from the list, it must be returned to the free storage.
+
 ![Regular list](/img/2023/regular.png)
 
 ## Intrusive lists
@@ -79,7 +89,7 @@ The definitions are organised within a namespace under `micro_os_plus`:
 
 - `micro_os_plus::utils`
 
-### Intrusive double linked lists class
+### Intrusive doubly linked lists class
 
 The intrusive lists can be defined by instantiating a class template:
 
@@ -96,9 +106,9 @@ template <class T, class N, N T::*MP, class L = double_list_links,
 class intrusive_list;
 ```
 
-See the reference [Intrusive double linked lists](pathname:///reference/group__micro-os-plus-utils-lists-intrusive-lists.html) page.
+See the reference [Intrusive doubly linked lists](pathname:///reference/group__micro-os-plus-utils-lists-intrusive-lists.html) page.
 
-### Double linked lists class
+### Doubly linked lists class
 
 For simpler use cases, such as traditional lists or low intrusive lists,
 there is a simpler template:
@@ -114,7 +124,7 @@ template <class T, class L = double_list_links>
 class double_list;
 ```
 
-See the reference [Double linked lists](pathname:///reference/group__micro-os-plus-utils-lists-double-lists.html) page.
+See the reference [Doubly linked lists](pathname:///reference/group__micro-os-plus-utils-lists-double-lists.html) page.
 
 ### Methods
 

website/doxygen/topics.doxyfile

@@ -45,11 +45,11 @@ not provide equivalent definitions for the C programming language.
 
 /**
 
-@defgroup micro-os-plus-utils-lists-intrusive-lists Intrusive double linked lists
+@defgroup micro-os-plus-utils-lists-intrusive-lists Intrusive doubly linked lists
 @ingroup micro-os-plus-utils-lists-cpp-api
 @details
 
-Intrusive lists are double linked lists that keep the two pointers inside
+Intrusive lists are doubly linked lists that keep the two pointers inside
 each linked object.
 
 The intrusive lists can be defined by instantiating the
@@ -91,7 +91,7 @@ static_children_list kids_registry;
 
 /**
 
-@defgroup micro-os-plus-utils-lists-double-lists Double linked lists
+@defgroup micro-os-plus-utils-lists-double-lists Doubly linked lists
 @ingroup micro-os-plus-utils-lists-cpp-api
 @details