JetBrains / JetBrains/writerside-github-action

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

Open
#27 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
84
Forks
6
PR merge metrics
No merged PRs in 30d

Description

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

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.