-
Notifications
You must be signed in to change notification settings - Fork 75
docs: allow publishing docs from forked PRs #327
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: allow publishing docs from forked PRs #327
Conversation
Fixes issues with race conditions by enabling folder cleaning Requires maintainer approval via an environment. Adapt workflows to correctly handle pull_request_target by explicitly checking out the correct repository. Flattened folder structure gh-pages/ ................. │─ pr-42/ # PR eclipse-score#42 preview │─ pr-99/ # PR eclipse-score#99 preview │─ feature-x/ # Feature branch preview │─ v17/ # Tagged release │─ main/ # main branch (alternatively "latest") In addition to this repo, there are a couple more changes that are needed: - the otterdog repo has to be updated and add the proper maintainers to the github-pages env - the eclipse-score.github.io repo has to be updated so that the Docs refrences the /main folder by default closes eclipse-score#168 eclipse-score#194 eclipse-score#269 Signed-off-by: Dan Calavrezo <dan.calavrezo.ext@qorix.ai>
Signed-off-by: Dan Calavrezo <dan.calavrezo.ext@qorix.ai>
AlexanderLanin
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry, even more questions
Addressed PR comments. - use base action when performing deployment - added extra comments Signed-off-by: Dan Calavrezo <dan.calavrezo.ext@qorix.ai>
Signed-off-by: Dan Calavrezo <dan.calavrezo.ext@qorix.ai>
No worries, they are very helpful and improved the PR. |
.github/workflows/docs.yml
Outdated
| cancel-in-progress: false | ||
| runs-on: ubuntu-latest | ||
| needs: docs-build | ||
| environment: github-pages # Requires approval before execution |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I just noticed the entire idea / concept should be documented somewhere. (separate PR, so we can get this one finally merged)
Signed-off-by: Dan Calavrezo <dan.calavrezo.ext@qorix.ai>
|
open points:
|
Since we execute the action from the base repo, we don't need maintainers to trigger the workflow executions. Signed-off-by: Dan Calavrezo <dan.calavrezo.ext@qorix.ai>
7a4db79 to
5e5a1ed
Compare
|
Yes, a /main folder will be created after the merge the |
Fixes issues with race conditions by enabling folder cleaning
Requires maintainer approval via an environment.
Adapt workflows to correctly handle pull_request_target by explicitly checking out the correct repository.
Flattened folder structure
gh-pages/
.................
│─ pr-42/ # PR #42 preview
│─ pr-99/ # PR #99 preview
│─ feature-x/ # Feature branch preview
│─ v17/ # Tagged release
│─ main/ # main branch (alternatively "latest")
In addition to this repo, there are a couple more changes that are needed:
closes #168 #194 #269