Skip to content

doc: Fix end-of-file newline in update_devs.py - #751

Open
tfcollins wants to merge 8 commits into
mainfrom
tfcollins/doc-update
Open

doc: Fix end-of-file newline in update_devs.py#751
tfcollins wants to merge 8 commits into
mainfrom
tfcollins/doc-update

Conversation

@tfcollins

Copy link
Copy Markdown
Collaborator

Description

Summarize the change and the motivation. Link the issue this fixes.

Fixes # (issue)

Type of change

  • Bug fix
  • New device class interface
  • New feature on an existing class
  • Breaking change
  • Documentation only
  • Test or CI only

How has this been tested?

State explicitly whether this was tested against real hardware, an emulated context (iio-emu), or not run. Name the part(s) and the context URI or board used.

  • Hardware / emulation:
  • Commands run (e.g. python3 -m pytest -k ad4080 --adi-hw-map):
  • Result:

Test configuration

  • Kernel / libiio version:
  • OS:
  • FPGA carrier (if applicable):

Documentation

  • No documentation change needed
  • Updated existing docs under doc/source/
  • Added a new device page and linked it from the relevant toctree

New device class interfaces

Skip this section if the PR does not add a new device class.

  • Class extends one of the common base classes in adi.device_base (rx_chan_comp, tx_chan_comp, or a _no_buff variant). If not, explain why in the description. See the Device Base Classes developer doc page.
  • compatible_parts lists every part number this class supports
  • Part numbers added to supported_parts.md (verify with invoke checkparts)
  • Emulation context (xml_gen, not iio_genxml) added under test/emu/ and referenced from a test
  • Tests added that run against the emulation context in CI

Checklist

  • invoke precommit passes locally
  • All commits are signed off (Signed-off-by: Name <email>)
  • No new warnings from the build or doc generation
  • Dependent changes in libiio, kernel, or HDL are merged and referenced

tfcollins added 6 commits May 16, 2026 19:57
Split the Quick Start, Examples, and Developer Guide into focused sub-sections.
Reorganized the supported device list into logical categories (Transceivers, Converters, etc.).
Added new guides for Architecture, Performance Optimization, and Troubleshooting.
Modified update_devs.py to support categorized device listing in index.rst.
Fixed trailing whitespace and formatting in troubleshooting and performance guides.
Ensured check_for_missing.py passes by keeping auto-generated files in sync.
@github-actions

Copy link
Copy Markdown

Generated documentation for this PR is available at Link

@github-actions

github-actions Bot commented May 16, 2026

Copy link
Copy Markdown

Test Results

1 812 tests  ±0     508 ✅ ±0   5m 47s ⏱️ - 3m 9s
    1 suites ±0   1 304 💤 ±0 
    1 files   ±0       0 ❌ ±0 

Results for commit a41cb68. ± Comparison against base commit 562abf0.

♻️ This comment has been updated with latest results.

tfcollins added 2 commits May 16, 2026 20:23
Updated update_devs.py to include manual device RST files (adis*) in the categorized index.rst. This resolves 'document isn't included in any toctree' warnings that were causing CI failures with SPHINXOPTS='-W'.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant