adrv936x: Add u-boot-env page as orphan

[StancaPop]

Type

• Documentation
• Bug fix
• New feature
• Continuous integration

Checklist

• I have performed a self-review of changes
• I have followed the guidelines:
  • https://analogdevicesinc.github.io/documentation/contributing/docs_guidelines.html
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/index.html
  • https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#documentation-structure
• I have used the appropriate roles and directives:
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/roles.html
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/directives.html
• I ensured that binary data was committed to git lfs:
  • https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#adding-images-and-other-binary-files
• I have built the pages I edited or created, using either make html or adoc serve:
  • https://analogdevicesinc.github.io/doctools/cli.html#serve
• I have signed-off my commits and believe my contribution improves the repository.

[github-actions]

LLM review

This series adds a new orphan troubleshooting page for the ADRV9361/ADRV9364
u-boot environment fix, imported from dokuwiki.

run: 31175543058

0da39dc - Add u-boot-env page as orphan

Ordering bug: the .. _adrv936x u-boot-env-fix: label is placed before the
.. imported from: comment, so the comment sits between the label and the section
title. Sphinx's implicit target-to-title association requires the target to
immediately precede the title, so any :ref: to this label fails to resolve
(WARNING: Failed to create a cross reference. A title or caption not found).
Reproduced with a minimal isolated Sphinx project and confirmed against the ~100
other imported pages in this repo, which all put the imported from comment
before the label.

The page is also :orphan: and, before this fix, nothing else in the repository
referenced it, making it unreachable from any other doc page.

Minor: the new .. image:: for the MAC address sticker is missing :alt: text
(every other image in this reference design sets one), and the EngineerZone
support link uses a raw external hyperlink instead of the :ez: role already used
elsewhere in the same directory (revision-history.rst).

CI warnings

No CI log was provided for this run; issues above were found by rebuilding the
docs locally (adoc serve --once -v -s solutions/reference-designs/adrv9361z7035
and make html), which reproduces the ref.ref warning once a cross-reference to
the new label is added.

Verification data

The original dokuwiki page (resources/eval/user-guides/adrv936x_rfsom/u-boot-env-fix?do=export_raw)
was fetched and compared line by line against the new .rst; content, commands
and the boot log excerpt match faithfully.

Suggested patches

Apply the suggested patches with:

cd path/to/repository
export GITHUB_TOKEN=ghp_***
apply-patches --repo=analogdevicesinc/documentation 31175543058

Install instructions

The following one-liner installs the script if not present already:

curl -fSsL "https://raw.githubusercontent.com/analogdevicesinc/doctools/refs/heads/main/ci/scripts/apply-patches.sh"      -o ~/.local/bin/apply-patches.sh &&   grep -q "/apply-patches.sh" ~/.bashrc || echo "source ~/.local/bin/apply-patches.sh" >> $_ ; . $_

More information at AI Usage.