[scarthgap] Pull request

["Antonin Godard" <antonin.godard@bootlin.com>]

The following changes since commit dc9a5aa19ca2a0b5ad866f0329b8a030542ca0c6:

  ref-manual/variables.rst: document the QB_DEFAULT_BIOS variable (2026-08-13 10:29:21 +0200)

are available in the Git repository at:

  git@push.yoctoproject.org:yocto-docs scarthgap-next

for you to fetch changes up to c197e0c022549b4a787b0f1ed23f0d978539c673:

  README: update instructions for installing vale and sphinx-lint (2026-08-21 16:39:51 +0200)

----------------------------------------------------------------
Antonin Godard (12):
      index.rst: add introduction paragraphs
      index.rst: move the contributor guide out of the Manuals section
      index.rst: move the "Overview and Concepts" manual in the "Introduction and Overview" section
      index.rst: move external links to the bottom of the intro section
      overview-manual: move the intro content in the index
      bsp-guide: rename to bsp-manual
      contributor-guide/identify-component.rst: use the same tense as other section
      bitbake.rst: rename section to "BitBake User Manual"
      index.rst: move release notes in their own section
      index.rst: show the intro paragraph only for html-based docs
      ref-manual/variables.rst: document the PACKAGE_NO_LOCALE variable
      ref-manual/variables.rst: document the PACKAGEFUNCS variable

Daiane Angolini (2):
      ref-manual/features.rst: fix some cross references
      docs-wide: fix manual names in cross references

Quentin Schulz (1):
      README: update instructions for installing vale and sphinx-lint

 documentation/Pipfile                              |   2 +
 documentation/README                               |  29 +++++----
 documentation/bitbake.rst                          |   6 +-
 documentation/bsp-guide/figures/bsp-title.png      | Bin 17388 -> 0 bytes
 documentation/bsp-guide/index.rst                  |  15 -----
 documentation/{bsp-guide => bsp-manual}/bsp.rst    |  34 +++++-----
 .../figures/bsp-dev-flow.png                       | Bin
 documentation/bsp-manual/index.rst                 |  15 +++++
 .../contributor-guide/identify-component.rst       |   4 +-
 documentation/dev-manual/layers.rst                |   6 +-
 documentation/dev-manual/new-machine.rst           |   2 +-
 documentation/dev-manual/start.rst                 |   2 +-
 documentation/dev-manual/upgrading-recipes.rst     |   2 +-
 documentation/index.rst                            |  70 ++++++++++++++++++---
 documentation/kernel-dev/advanced.rst              |   2 +-
 documentation/kernel-dev/common.rst                |   6 +-
 documentation/migration-guides/migration-2.5.rst   |   2 +-
 documentation/overview-manual/concepts.rst         |   2 +-
 .../overview-manual/development-environment.rst    |   4 +-
 documentation/overview-manual/index.rst            |  59 ++++++++++++++++-
 documentation/overview-manual/intro.rst            |  69 --------------------
 documentation/overview-manual/yp-intro.rst         |   4 +-
 documentation/ref-manual/classes.rst               |   6 +-
 documentation/ref-manual/faq.rst                   |   6 +-
 documentation/ref-manual/features.rst              |   4 +-
 documentation/ref-manual/resources.rst             |   2 +-
 documentation/ref-manual/structure.rst             |   2 +-
 documentation/ref-manual/terms.rst                 |   4 +-
 documentation/ref-manual/variables.rst             |  59 ++++++++++++++++-
 documentation/sphinx-static/theme_overrides.css    |   4 ++
 documentation/test-manual/intro.rst                |   2 +-
 .../transitioning-to-a-custom-environment.rst      |   2 +-
 documentation/what-i-wish-id-known.rst             |   6 +-
 33 files changed, 269 insertions(+), 163 deletions(-)
 delete mode 100644 documentation/bsp-guide/figures/bsp-title.png
 delete mode 100644 documentation/bsp-guide/index.rst
 rename documentation/{bsp-guide => bsp-manual}/bsp.rst (98%)
 rename documentation/{bsp-guide => bsp-manual}/figures/bsp-dev-flow.png (100%)
 create mode 100644 documentation/bsp-manual/index.rst
 delete mode 100644 documentation/overview-manual/intro.rst