docs: add preview feature functionality with GitHub workflows #6471
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What this PR does:
This PR generates a github preview if the changes are made solely in the docs folder and generates a deployed website if the branch is prefixed with
docs-. The automation also added the deployed website which is made using gh pages in the PR description.Why we need it:
For better PR review velocity for maintainers
Which issue(s) this PR fixes:
Fixes #6467
I have tested the functionality locally on a seperate repo and it is working as expected. To make this work, after merging and the first workflow run, the pages settings of the repo will have to change to select gh pages from the list of branches (I have added a screenshot below for reference):
