Skip to content

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

Merged
praneethbajjuri merged 1 commit into
TexasInstruments:masterfrom
jonaswood01:develop
Aug 9, 2025
Merged

docs(U-Boot): Refactor K3 and OMAP Build Guide#339
praneethbajjuri merged 1 commit into
TexasInstruments:masterfrom
jonaswood01:develop

Conversation

@jonaswood01

Copy link
Copy Markdown
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.

@github-actions

github-actions Bot commented Jul 1, 2025

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Jul 1, 2025

Copy link
Copy Markdown

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".

@github-actions

github-actions Bot commented Jul 1, 2025

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Jul 1, 2025

Copy link
Copy Markdown

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)

@cshilwant cshilwant left a comment

Copy link
Copy Markdown
Member

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

Comment thread source/devices/AM57X/linux/Release_Specific_Release_Notes.rst Outdated
Comment thread source/linux/Foundational_Components/U-Boot/BG-Target-Images-OMAP.rst Outdated
Comment thread source/linux/Foundational_Components/U-Boot/BG-Setup-OMAP.rst Outdated
Comment thread source/linux/Foundational_Components/U-Boot/BG-Environment-K3.rst Outdated
Comment thread source/linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst
Comment thread source/linux/Foundational_Components/U-Boot/BG-Build-OMAP.rst Outdated
Comment thread source/linux/Foundational_Components/U-Boot/Users-Guide.rst
@github-actions

Copy link
Copy Markdown

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".

@jonaswood01 jonaswood01 force-pushed the develop branch 2 times, most recently from d4f4a0a to 4938e05 Compare July 25, 2025 18:20
@jonaswood01

Copy link
Copy Markdown
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.

StaticRocket
StaticRocket previously approved these changes Jul 27, 2025

@StaticRocket StaticRocket left a comment

Copy link
Copy Markdown
Member

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.

@cshilwant cshilwant left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Resolve merge conflicts

source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

@github-actions

github-actions Bot commented Aug 5, 2025

Copy link
Copy Markdown

New warnings found with rstcheck:

source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst:131: (INFO/1) Duplicate implicit target name: "ti-linux-firmware".

@jonaswood01

jonaswood01 commented Aug 5, 2025

Copy link
Copy Markdown
Contributor Author

Rebased and resolved merge conflict. @praneethbajjuri please review

New warnings found with rstcheck:

source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst:131: (INFO/1) Duplicate implicit target name: "ti-linux-firmware".

@cshilwant I had to change your new ti-linux-firmware reference to ti-linux-firmware v11.01.07 on line 52 of this file to fix this

StaticRocket
StaticRocket previously approved these changes Aug 5, 2025
praneethbajjuri
praneethbajjuri previously approved these changes Aug 6, 2025
@StaticRocket

Copy link
Copy Markdown
Member

Ah, needs to be rebased now

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 <jw@ti.com>
Comment thread source/devices/AM62AX/linux/Release_Specific_Release_Notes.rst
@praneethbajjuri praneethbajjuri dismissed cshilwant’s stale review August 9, 2025 00:58

Overriding to pull

@praneethbajjuri praneethbajjuri merged commit 6814540 into TexasInstruments:master Aug 9, 2025
5 of 6 checks passed
@jonaswood01 jonaswood01 deleted the develop branch August 11, 2025 17:35
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.