Skip to content

Add support for generating multiversion documentation#949

Merged
Parth Arora (partaror) merged 1 commit into
qualcomm:mainfrom
parth-07:MultiversionDocs
Mar 31, 2026
Merged

Add support for generating multiversion documentation#949
Parth Arora (partaror) merged 1 commit into
qualcomm:mainfrom
parth-07:MultiversionDocs

Conversation

@parth-07

@parth-07 Parth (parth-07) commented Mar 18, 2026

Copy link
Copy Markdown
Contributor

This commit add supports for generating multiversion documentation. The
new targets added that enable this functionality are:

  • eld-docs-<release> // can be one of the releases such as 22.x, and main.
  • eld-docs-all-releases // Builds all releases
  • eld-docs-assemble // Combines all the version documentation and generates the version selector page.
  • eld-docs-multiversion // eld-docs-all-releases + eld-docs-assemble

eld-docs-<release> creates the documentation by creating an eld
worktree in ${BUILD_DIR}/tools/eld/docs/multiversion/_work/${release}
with the requested release checked out. Please note that we cannot use
the original source repository to generate documentations of different
releases.

In the generated docs:

  • the homepage (/), and /main will display the main branch
    documentation.
  • /22.x and /stable will display the release/22.x branch documentation.
  • /versions.html will display a basic documentation version selector
    menu.

I have hosted the multiversion documentation here https://parth-07.github.io/eld/ to help with reviewing the functionality.
Version selector page: https://parth-07.github.io/eld/versions.html.

@parth-07
Parth (parth-07) force-pushed the MultiversionDocs branch 4 times, most recently from b5640a0 to fb611ce Compare March 18, 2026 10:12
@quic-seaswara

Copy link
Copy Markdown
Contributor

Waiting to see this

@parth-07
Parth (parth-07) force-pushed the MultiversionDocs branch 2 times, most recently from 895f276 to 184b5b7 Compare March 27, 2026 10:09
@parth-07
Parth (parth-07) marked this pull request as ready for review March 27, 2026 10:09
@parth-07 Parth (parth-07) changed the title Add support for multiversion documentation Add support for generating multiversion documentation Mar 27, 2026
@parth-07

Copy link
Copy Markdown
Contributor Author

Waiting to see this

I have hosted the multiversion documentation here https://parth-07.github.io/eld/ (displays the main branch documentation).
Version selector page: https://parth-07.github.io/eld/versions.html

This commit add supports for generating multiversion documentation. The
new targets added that enable this functionality are:

- `eld-docs-<release>` // <release> can be one of the releases such as
                       //  22.x, and main.
- `eld-docs-all-releases` // Builds all releases
- `eld-docs-assemble` // Combines all the version documentation and
                      //  generates the version selector page.
- `eld-docs-multiversion` // eld-docs-all-releases + eld-docs-assemble

`eld-docs-<release>` creates the documentation by creating an eld
worktree in ${BUILD_DIR}/tools/eld/docs/multiversion/_work/${release}
with the requested release checked out. Please note that we cannot use
the original source repository to generate documentations of different
releases.

In the generated docs:

- the homepage ('/'), and '/main' will display the 'main'
  documentation.
- '/22.x' and '/stable' will display the 'release/22.x' documentation.
- '/versions.html' will display a basic documentation version selector
  menu.

Signed-off-by: Parth Arora <partaror@qti.qualcomm.com>
@partaror
Parth Arora (partaror) merged commit 3921196 into qualcomm:main Mar 31, 2026
3 of 4 checks passed
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.

3 participants