Skip to content

How to deploy multiple versions of the documentation on different branches in one time? #27

Description

@Ylimhs

Hi,

I would like to deploy multiple versions of the documentation using GitHub Actions and GitHub Pages. Ideally, I want to manage this in one project with one instance, but have different branches represent different versions of the docs.

Questions:

Is it possible to build documentation from multiple branches at once and publish them together as a multi-version documentation site?

Expected setup

Branches in the repository: (one instance)

main → latest development version

release/1.0 → stable v1.0

release/2.0 → stable v2.0

Documentation site structure on GitHub Pages:

/latest/ → built from main

/v1.0/ → built from release/1.0

/v2.0/ → built from release/2.0

other ways

If I use group builds, then I need to have multiple instances within a single branch at the same time, and group builds also don’t support building one instance across multiple branches with different versions,I don't want to use this method.

Thanks

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions