Update in-depth explanations

tomicapretto · tomicapretto · commit f76dc7d54b0a · 2026-01-27T19:55:22.000-03:00
diff --git a/docs/source/contributing/diataxis_for_arviz.md b/docs/source/contributing/diataxis_for_arviz.md
@@ -33,7 +33,7 @@ which can nor should follow the Diátaxis framework.
 ArviZ is a library with a strong visualization component.
 This translates for example into some duplicity when it comes to reference content.
 
-Both the {ref}`example_gallery` and the {ref}`api` pages are reference content.
+Both the {ref}`arviz_plots:example_gallery` and the {ref}`arviz_plots:api` pages are reference content.
 The API reference indexes by name and contains the description of each object,
 whereas the Example Gallery indexes by image and to avoid excessive duplication,
 links to the respective API page.
diff --git a/docs/source/contributing/doc_toolchain.md b/docs/source/contributing/doc_toolchain.md
@@ -1,10 +1,13 @@
 (doc_toolchain)=
 # Documentation toolchain
 
+:::{caution} Some content in this page may be outdated.
+:::
+
 ArviZ documentation is built using a Python documentation tool, [Sphinx](https://www.sphinx-doc.org/en/master/).
 Sphinx converts `rst`(restructured text) files into HTML websites.
 There are different extensions available for converting other types of files
-like markdown, jupyter notebooks, etc. into HTML websites.
+like markdown, Jupyter notebooks, etc. into HTML websites.
 
 ArviZ [docs](https://github.com/arviz-devs/arviz/tree/main/doc/source) consist of `.rst`, `.md` and `.ipynb` files.
 It uses `myst-parser` and `myst-nb` for `.md` and `.ipynb` files.
diff --git a/docs/source/contributing/index.md b/docs/source/contributing/index.md
@@ -171,5 +171,4 @@ syntax_guide
 
 doc_toolchain
 diataxis_for_arviz
-plotting_backends
 :::
diff --git a/docs/source/contributing/plotting_backends.md b/docs/source/contributing/plotting_backends.md
