-
Notifications
You must be signed in to change notification settings - Fork 8
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-1262] Add GH action for per-page preview links #1091
base: main
Are you sure you want to change the base?
Conversation
HTML previews:
Preview links work **only** after the `Cloudflare Pages` build check succeeds. Links are generated only for new and modified |
Deploying docs with
|
Latest commit: |
3787b25
|
Status: | ✅ Deploy successful! |
Preview URL: | https://4d312017.docodile.pages.dev |
Branch Preview URL: | https://docs-1262.docodile.pages.dev |
2b35400
to
804c577
Compare
d1dc1ea
to
b1c94ea
Compare
ef782dc
to
8292892
Compare
e77d5a5
to
93b0bef
Compare
93b0bef
to
5a51587
Compare
issue-number: ${{ github.event.pull_request.number }} | ||
edit-mode: replace | ||
body: | | ||
<h3>HTML previews:</h3><ul>${{ env.body }}</ul><p>Preview links work **only** after the `Cloudflare Pages` build check succeeds. Links are generated only for new and modified <code>.md</code> files under <code>content/</code>.</p><p><a href="https://github.com/wandb/docs/issues/new?title=Feedback+about+HTML+preview+comments&assignees=mdlinville&body=Link+to+PR+and+describe+the+issue">Feedback about HTML previews</a> |
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.
If we want to be concise with the comment, we can move:
"Links are generated only for new and modified .md
files under content/
."
to a CONTRIBUTING.md
file.
.github/workflows/changed_files.yml
Outdated
output+="<li>$file</li>" | ||
} | ||
|
||
for file in ${files[@]}; do |
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.
The format of the markdown is a little confusing.
Can separate the non generated vs generated links into separate sections or add "Generated preview" to the second bullet point in body
?
i.e. From this:
HTML previews:
- No preview: filename
- filename (generated preview)
To something like:
HTML previews:
- No preview generated for: filename
- Generated preview: filename, filename, filename
or perhaps even
HTML previews:
- No preview generated for:
- filename
- filename
- Generated preview:
- filename
- filename
DOCS-1262 Add GH action for per-page preview links to aid review of docs PRs
content/**/*.md
to the corresponding Cloudflare URL, including interpreting_index.md
Docs: https://github.com/marketplace/actions/changed-files
Inspiration: https://github.com/cockroachdb/docs/blob/main/.github/workflows/changed_files.yml