Skip to content

docs(U-Boot): Refactor K3 and OMAP Build Guide #339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

jonaswood01
Copy link
Contributor

Mostly cleanup and organization. Some content updated on OMAP. Turns large build guide into its own section under U-Boot, with 6 pages under the build guide. Give feedback if content needs more updating, and I will address in future PR.

Copy link

github-actions bot commented Jul 1, 2025

New issues found with check_toc_txt.py:

WARNING:root:Invalid slug: configs/AM65X/AM65X_linux_toc.txt:22 linux/Foundational_Components/U-Boot/Release-Notes
WARNING:root:Invalid slug: configs/AM57X/AM57X_linux_toc.txt:24 linux/Foundational_Components/U-Boot/Release-Notes
WARNING:root:Invalid slug: configs/AM437X/AM437X_linux_toc.txt:25 linux/Foundational_Components/U-Boot/Release-Notes

Copy link

github-actions bot commented Jul 1, 2025

New warnings found with rstcheck:

source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:39: (WARNING/2) Bullet list ends without a blank line; unexpected unindent.
source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:5: (INFO/1) Enumerated list start value not ordinal-1: "2" (ordinal 2)
source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:5: (INFO/1) Enumerated list start value not ordinal-1: "3" (ordinal 3)
source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:5: (INFO/1) Enumerated list start value not ordinal-1: "4" (ordinal 4)
source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst:9: (INFO/1) Duplicate implicit target name: "target images".
source/linux/Foundational_Components/U-Boot/BG-Target-Images-OMAP.rst:9: (INFO/1) Duplicate implicit target name: "target images".

Copy link

github-actions bot commented Jul 1, 2025

New issues found with check_toc_txt.py:

WARNING:root:Invalid slug: configs/AM65X/AM65X_linux_toc.txt:22 linux/Foundational_Components/U-Boot/Release-Notes
WARNING:root:Invalid slug: configs/AM57X/AM57X_linux_toc.txt:24 linux/Foundational_Components/U-Boot/Release-Notes
WARNING:root:Invalid slug: configs/AM437X/AM437X_linux_toc.txt:25 linux/Foundational_Components/U-Boot/Release-Notes

Copy link

github-actions bot commented Jul 1, 2025

New warnings found with rstcheck:

source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:5: (INFO/1) Enumerated list start value not ordinal-1: "2" (ordinal 2)
source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:5: (INFO/1) Enumerated list start value not ordinal-1: "3" (ordinal 3)
source/linux/Foundational_Components/U-Boot/BG-Bootflow-OMAP.rst:5: (INFO/1) Enumerated list start value not ordinal-1: "4" (ordinal 4)

Copy link
Member

@cshilwant cshilwant left a comment

Choose a reason for hiding this comment

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

Resolve merge conflicts and failures reported by 3 workflows

Copy link

New warnings found with rstcheck:

source/linux/Foundational_Components/U-Boot/BG-Target-Images-OMAP.rst:9: (INFO/1) Duplicate implicit target name: "target images".
source/linux/Foundational_Components/U-Boot/BG-Target-Images-K3.rst:9: (INFO/1) Duplicate implicit target name: "target images".

Mostly cleanup and organization. Some content updated on OMAP.
Turns large build guide into its own section under U-Boot,
with 6 pages under the build guide. Give feedback if content
needs more updating, and I will address in future PR.

Signed-off-by: Jonas Wood <[email protected]>
@jonaswood01
Copy link
Contributor Author

Changed commit tag to "refactor". Addressed all feedback, resolved merge conflicts, and passed all checks except Vale. I reviewed output from Vale and felt no spelling or grammar changes are necessary, leaving as-is. Please re-review.

Copy link
Member

@StaticRocket StaticRocket left a comment

Choose a reason for hiding this comment

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

Considering this is primarily a refactor splitting the doc we shouldn't be too concerned about vale right now. Other warnings are still valid.

@jonaswood01 jonaswood01 requested a review from cshilwant July 28, 2025 12:07
@jonaswood01 jonaswood01 requested a review from sadik-smd July 28, 2025 12:07
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.