Skip to content

adds user guide docs#3215

Draft
rbolboac wants to merge 8 commits into
mainfrom
dev/doc_user_help
Draft

adds user guide docs#3215
rbolboac wants to merge 8 commits into
mainfrom
dev/doc_user_help

Conversation

@rbolboac

Copy link
Copy Markdown
Contributor

Pull Request Description

Please replace this with a detailed description and motivation of the changes.
You can tick the checkboxes below with an 'x' between square brackets or just check them after publishing the PR.
If this PR contains a breaking change, list dependent PRs and try to push all related PRs at the same time.

PR Type

  • Bug fix (change that fixes an issue)
  • New feature (change that adds new functionality)
  • Breaking change (has dependencies in other repos or will cause CI to fail)

PR Checklist

  • I have followed the Coding style guidelines
  • I have complied with the Submission Checklist
  • I have performed a self-review of the changes
  • I have commented my code, at least hard-to-understand parts
  • I have build all projects affected by the changes in this PR
  • I have tested in hardware affected projects, at the relevant boards
  • I have signed off all commits from this PR
  • I have updated the documentation (wiki pages, ReadMe etc), if applies

rbolboac added 8 commits July 15, 2026 15:03
Add the getting_started Sphinx guide: an end-to-end build/flash/debug/run
walkthrough using the IIO Demo project and the no_os_build.py CMake flow.
Wire it into the toctree.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Add the architecture Sphinx guide: the layer model, the platform_ops
dispatch mechanism, and the init_param/descriptor idiom. Wire it into
the toctree.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Add the iio_framework Sphinx guide: the IIO object model (device/channel/
attribute/buffer/trigger) and how a driver plugs into it. Wire it into
the toctree.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Add the porting_guide Sphinx guide: adding a new platform (HAL
implementation) or board. Wire it into the toctree.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Add the configuration_guide Sphinx guide: the Kconfig/defconfig layering
and how it becomes config.cmake and no_os_config.h. Wire it into the
toctree.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Add the troubleshooting Sphinx guide: common issues by workflow stage,
plus an FAQ. Wire it into the toctree.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Update the WSL USB passthrough guide to the usbipd-win 4.0+ CLI:
top-level list/bind/attach/detach with --wsl/--busid, and the required
one-time bind step. Drop the obsolete in-WSL USB/IP client tooling
install, which is no longer needed as of usbipd-win 4.0.0.

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
Clarify that the Git Bash / MSYS2 GCC prerequisites apply only to the
legacy Makefile build; the CMake flow can be built from any console
(cmake, ninja, python on PATH plus the vendor SDK).

Assisted-by: Claude Opus 4.8
Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
@rbolboac

Copy link
Copy Markdown
Contributor Author
  • still needs work but a review can be performed and is much appreciated

@rbolboac rbolboac changed the title Dev/doc user help adds user guide docs Jul 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant