solutions/reference-design/ad57xx-ardz: added docs for ad57xx

[reyolmedo]

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 documentation for the EVAL-AD57XXARDZ precision DAC evaluation board family, covering the AD5760/AD5780/AD5781/AD5790/AD5791 devices with quickstart guides for Cora Z7S and DE10-Nano FPGA carriers.

run: 29590971838

86e21bb - ad57xx docs

BOM in index.rst: index.rst starts with a UTF-8 BOM (0xEF 0xBB 0xBF) which causes incorrect rendering and shifts vale line-number reporting.

Vale failures — Linux vs linux: The ADI vocabulary (accept.txt) defines linux as the accepted lowercase form. Nine occurrences of Linux in plain text across index.rst, prerequisites.rst, and quickstart/coraz7s.rst trigger vale:Vale.Terms CI failures.

Grid indentation bug in index.rst: The .. grid:: directive showing the eval board images is indented 3 spaces, nesting it inside the last Applications: bullet item. It should be at column 0.

Figure indentation bug in quickstart/de10nano.rst: The AD57xx/DE10-Nano setup figure is indented 3 spaces inside its section, making it a block quote rather than a directive.

Raw URLs instead of :adi: role in user-guide.rst: The UG-2209 and UG-2225 user guide links use raw https://www.analog.com/media/... URLs. The convention throughout the repo is to use the :adi: role.

Redundant custom titles on build_hdl references: :external+hdl:ref:Build an HDL project <build_hdl> repeats the label's own title unnecessarily. Should be `:external+hdl:ref:`build_hdl.

CI warnings

The vale:Vale.Terms warning for :git-no-os: (line 138 of index.rst, col 20) is a false positive — vale scans the role name git-no-os as plain text and flags no-os as wrong. The role name cannot be changed.

The check-doc case warnings (ADIN1110_Hw_Config.png, TeraTerm.png, etc.) are pre-existing and unrelated to this PR.

Verification data

• Built with adoc serve --once --sparse docs/solutions/reference-designs/ad57xx-ardz — 0 errors.
• Ran vale --config=.github/styles/vale-enforcement.ini on all 6 .rst files — 0 errors after fixes.
• Fetched https://www.analog.com/media/en/en-pdf-sitemap.xml to confirm UG-2209 and UG-2225 exist.
• Verified intersphinx labels (ad57xx_ardz, build_hdl, build_guide, use-kuiper-image) against published HDL, no-OS, and Kuiper inventory files.

Suggested patches

Apply the suggested patches with:

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

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.