This series started out with a much more ambitious goal of documenting
every undocumented generic kernel data structure. About 6 hours in I had
to tell myself that maybe it's better to do this piece-meal. So here is
the first of what will hopefully be many similar series: documenting
linked lists.
It starts out with a mostly unrelated docs patch for sphinx usage,
because I couldn't help myself.
The main patch follows, which is to add some rudimentary documentation
for linked lists, to test the waters on how receptive the community is
towards this type of documentation.
Should this style of documentation be seen as acceptable or even wanted,
then I'll continue in subsequent series to expand both this document,
and move on to other underdocumented data structures, such as
hashtables.
Based against lwn/docs-next, but b4 should let you know already.
Signed-off-by: Nicolas Frattaroli <nicolas.frattaroli@xxxxxxxxxxxxx>
---
Nicolas Frattaroli (2):
docs: Document how to use the recommended docs theme
docs: document linked lists
Documentation/core-api/index.rst | 1 +
Documentation/core-api/list.rst | 390 +++++++++++++++++++++++++++++++++++++
Documentation/doc-guide/sphinx.rst | 3 +-
3 files changed, 393 insertions(+), 1 deletion(-)
---
base-commit: a556bd882b9482f1b7ea00fcf07f9bc169f404c8
change-id: 20250520-linked-list-docs-ce5b956d4602
Best regards,
--
Nicolas Frattaroli <nicolas.frattaroli@xxxxxxxxxxxxx>
