Skip to content

NXP Backend: Update documentation to the new scheme#15219

Merged
robert-kalmar merged 1 commit into
pytorch:mainfrom
nxp-upstream:update-nxp-doc-new-template
Dec 12, 2025
Merged

NXP Backend: Update documentation to the new scheme#15219
robert-kalmar merged 1 commit into
pytorch:mainfrom
nxp-upstream:update-nxp-doc-new-template

Conversation

@robert-kalmar

@robert-kalmar robert-kalmar commented Oct 17, 2025

Copy link
Copy Markdown
Collaborator

Updating per template in #14873

cc @JakeStevens @digantdesai

@pytorch-bot

pytorch-bot Bot commented Oct 17, 2025

Copy link
Copy Markdown

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/15219

Note: Links to docs will display an error until the docs builds have been completed.

❌ 6 New Failures, 1 Unrelated Failure

As of commit 8df2c41 with merge base b6935ad (image):

NEW FAILURES - The following jobs have failed:

UNSTABLE - The following job is marked as unstable, possibly due to flakiness on trunk:

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@robert-kalmar robert-kalmar requested review from digantdesai and removed request for mergennachin October 17, 2025 11:03
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Oct 17, 2025
@github-actions

Copy link
Copy Markdown

This PR needs a release notes: label

If your change should be included in the release notes (i.e. would users of this library care about this change?), please use a label starting with release notes:. This helps us keep track and include your important work in the next release notes.

To add a label, you can comment to pytorchbot, for example
@pytorchbot label "release notes: none"

For more information, see
https://github.com/pytorch/pytorch/wiki/PyTorch-AutoLabel-Bot#why-categorize-for-release-notes-and-how-does-it-work.

Comment thread docs/source/backends/nxp/nxp-overview.md Outdated
Comment thread docs/source/backends/nxp/nxp-partitioner.rst Outdated
Comment thread docs/source/backends/nxp/nxp-overview.md Outdated
Comment thread docs/source/backends/nxp/nxp-partitioner.rst Outdated
Comment thread docs/source/backends/nxp/nxp-partitioner.rst Outdated
Comment thread docs/source/backends/nxp/nxp-partitioner.rst Outdated
@robert-kalmar robert-kalmar force-pushed the update-nxp-doc-new-template branch 2 times, most recently from 92eb4cb to fb21899 Compare October 17, 2025 12:50

@roman-janik-nxp roman-janik-nxp left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just backend with capital B and I see no further issues.

Comment thread docs/source/backends/nxp/nxp-partitioner.rst
Comment thread docs/source/backends/nxp/nxp-partitioner.rst
Comment thread docs/source/backends/nxp/nxp-partitioner.rst
Comment thread docs/source/backends/nxp/tutorials/nxp-tutorials.md
@@ -1,79 +0,0 @@
# NXP eIQ Neutron Backend

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, fixed.

@roman-janik-nxp roman-janik-nxp left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the XNNPACK files I see both, there is capital Backend in "XNNPACK Backend" at least in headings. What I meant is to unify it, as we have strings "NXP Backend" as well as "NXP backend". That is just a cosmetic issue. As it is a backend name, I think both words should be capitalized as it is a general rule in English. XNNPACK docs can also have mistakes.

EDIT: I have looked on other backends and they are mostly inconsistent too. It should be one or the other, but always capitalized in headings.

@robert-kalmar robert-kalmar force-pushed the update-nxp-doc-new-template branch from 50e151c to 02374b7 Compare October 17, 2025 15:36
@robert-kalmar

Copy link
Copy Markdown
Collaborator Author

In the XNNPACK files I see both, there is capital Backend in "XNNPACK Backend" at least in headings. What I meant is to unify it, as we have strings "NXP Backend" as well as "NXP backend". That is just a cosmetic issue. As it is a backend name, I think both words should be capitalized as it is a general rule in English. XNNPACK docs can also have mistakes.

EDIT: I have looked on other backends and they are mostly inconsistent too. It should be one or the other, but always capitalized in headings.

You are right, with the consistency. Went through it and unified it to use lower case everywhere. So Neutron backend, Neutron partitioner, Neutron quantizer....
In headings using capitals for all major words, i.e. using the "Title case" (https://en.wikipedia.org/wiki/Title_case) style headings.


## Step 1: Environment Setup

This tutorial is intended to be run from a Linux and uses Conda or Virtual Env for Python environment management. For full setup details and system requirements, see [Getting Started with ExecuTorch](/getting-started).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link gives 404.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@robert-kalmar Please fix this link.

@mergennachin

Copy link
Copy Markdown
Contributor

@robert-kalmar there's a merge conflict, can you rebase please

@mergennachin mergennachin reopened this Oct 20, 2025
@digantdesai digantdesai added the module: nxp Issues related to NXP Neutron NPU delegation and code under backends/nxp/ label Oct 27, 2025
@robert-kalmar robert-kalmar force-pushed the update-nxp-doc-new-template branch from 02374b7 to 9db5587 Compare December 11, 2025 12:41
Signed-off-by: Robert Kalmar <robert.kalmar@nxp.com>
@robert-kalmar robert-kalmar force-pushed the update-nxp-doc-new-template branch from 9db5587 to 8df2c41 Compare December 11, 2025 14:25
@robert-kalmar

Copy link
Copy Markdown
Collaborator Author

Failures seems unrelated.

@robert-kalmar robert-kalmar merged commit cdc2701 into pytorch:main Dec 12, 2025
230 of 247 checks passed
@robert-kalmar robert-kalmar deleted the update-nxp-doc-new-template branch December 12, 2025 11:19
xingguo01 pushed a commit to xingguo01/executorch that referenced this pull request Dec 18, 2025
Updating per template in
pytorch#14873

Signed-off-by: Robert Kalmar <robert.kalmar@nxp.com>
jirioc pushed a commit to nxp-upstream/executorch that referenced this pull request Dec 19, 2025
Updating per template in
pytorch#14873

Signed-off-by: Robert Kalmar <robert.kalmar@nxp.com>
mergennachin added a commit that referenced this pull request Jan 26, 2026
The backends-overview page was only showing 6 backends instead of 13.
This regression was introduced in commit cdc2701 (NXP Backend: Update
documentation to the new scheme #15219) which inadvertently reverted
correct toctree paths to incorrect ones during a table reformatting.


- Toctree entries used old flat paths (e.g., backends-xnnpack) instead
of the new subdirectory paths (e.g., backends/xnnpack/xnnpack-overview)
- A circular toctree dependency between nxp-overview.md and
nxp-dim-order.md caused Sphinx build failures


Test Plan: Built sphinx locally and rendered page



https://docs-preview.pytorch.org/pytorch/executorch/16861/backends-section.html
pytorchbot pushed a commit that referenced this pull request Jan 26, 2026
The backends-overview page was only showing 6 backends instead of 13.
This regression was introduced in commit cdc2701 (NXP Backend: Update
documentation to the new scheme #15219) which inadvertently reverted
correct toctree paths to incorrect ones during a table reformatting.

- Toctree entries used old flat paths (e.g., backends-xnnpack) instead
of the new subdirectory paths (e.g., backends/xnnpack/xnnpack-overview)
- A circular toctree dependency between nxp-overview.md and
nxp-dim-order.md caused Sphinx build failures

Test Plan: Built sphinx locally and rendered page

https://docs-preview.pytorch.org/pytorch/executorch/16861/backends-section.html
(cherry picked from commit 29b31da)
rascani pushed a commit that referenced this pull request Jan 26, 2026
The backends-overview page was only showing 6 backends instead of 13.
This regression was introduced in commit cdc2701 (NXP Backend: Update
documentation to the new scheme #15219) which inadvertently reverted
correct toctree paths to incorrect ones during a table reformatting.


- Toctree entries used old flat paths (e.g., backends-xnnpack) instead
of the new subdirectory paths (e.g., backends/xnnpack/xnnpack-overview)
- A circular toctree dependency between nxp-overview.md and
nxp-dim-order.md caused Sphinx build failures


Test Plan: Built sphinx locally and rendered page



https://docs-preview.pytorch.org/pytorch/executorch/16861/backends-section.html

Co-authored-by: Mergen Nachin <mnachin@meta.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. module: nxp Issues related to NXP Neutron NPU delegation and code under backends/nxp/

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants