-
Notifications
You must be signed in to change notification settings - Fork 2k
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: Add mdox
remote/local link checking and move web preprocess
#4357
Conversation
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.
Nice, I am afraid we might want to add transform in one go...
mdox
remote and local link checkingmdox
remote/local link checking and move web preprocess
b14d745
to
5bcdee5
Compare
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.
This looks amazing, LGTM mod minor nits. 💪🏽
.mdox.validate.yaml
Outdated
|
||
validators: | ||
# Smart validators to skip checking PR/issue links of Thanos, Prometheus and Cortex. | ||
- regex: 'thanos-io\/thanos' |
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.
Regex github.com
-> github
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.
Let's make it smarter
.mdox.validate.yaml
Outdated
# 301 errors even when curl-ed. | ||
- regex: 'envoyproxy\.io' | ||
type: 'ignore' | ||
# Due to rate limiting, mdox link checking is a time consuming process. |
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.
Let's remove that
.mdox.yaml
Outdated
- glob: "components/README.md" | ||
path: /components/_index.md | ||
frontMatter: | ||
template: | | ||
title: "{{ .Origin.FirstHeader }}" | ||
|
||
- glob: "operating/README.md" | ||
path: /operating/_index.md | ||
frontMatter: | ||
template: | | ||
title: "{{ .Origin.FirstHeader }}" | ||
|
||
- glob: "contributing/README.md" | ||
path: /contributing/_index.md | ||
frontMatter: | ||
template: | | ||
title: "{{ .Origin.FirstHeader }}" |
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 wonder if just one element will be enough:
- glob: "components/README.md" | |
path: /components/_index.md | |
frontMatter: | |
template: | | |
title: "{{ .Origin.FirstHeader }}" | |
- glob: "operating/README.md" | |
path: /operating/_index.md | |
frontMatter: | |
template: | | |
title: "{{ .Origin.FirstHeader }}" | |
- glob: "contributing/README.md" | |
path: /contributing/_index.md | |
frontMatter: | |
template: | | |
title: "{{ .Origin.FirstHeader }}" | |
- glob: "**/README.md" | |
path: _index.md | |
frontMatter: | |
template: | | |
title: "{{ .Origin.FirstHeader }}" |
@saswatamcode I think we're ready to merge 🚀 just need to fix the CI docs check. You will be able to repro this failure locally by running |
Hi @ianbillett! This PR has few blockers such as this and merging right now will break the website for previous version docs. I'll be raising PRs soon to fix those in mdox and in previous Thanos release branches and update this PR as well! This can be merged then! 🤗 |
5bcdee5
to
dbf0bee
Compare
mdox
remote/local link checking and move web preprocessmdox
remote/local link checking and move web preprocess
mdox
remote/local link checking and move web preprocessmdox
remote/local link checking and move web preprocess
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.
Nice, amazing! LGTM, just probably we need to update release branches. Let's do a script for this job, run and then merge this. WDYT?
.mdox.yaml
Outdated
lastmod: "{{ .Origin.LastMod }}" | ||
backMatter: | ||
template: | | ||
Found a typo, inconsistency or missing information in our docs? |
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.
We could try https://support.atlassian.com/bitbucket-cloud/docs/yaml-anchors/ (:
Signed-off-by: Saswata Mukherjee <saswataminsta@yahoo.com>
Signed-off-by: Saswata Mukherjee <saswataminsta@yahoo.com>
Signed-off-by: Saswata Mukherjee <saswataminsta@yahoo.com>
5214cc5
to
4442889
Compare
Signed-off-by: Saswata Mukherjee <saswataminsta@yahoo.com>
4442889
to
004ae26
Compare
1db45c4
to
c5ae260
Compare
Signed-off-by: Saswata Mukherjee <saswataminsta@yahoo.com>
c5ae260
to
5812b5b
Compare
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.
Thanks, amazing!
This PR adds
mdox
local and remote link checking with smart validation.cc: @bwplotka
Note: This fixes all links in docs. So while all links will work from GitHub now, website links may break. This will be fixed in subsequent PRs where current preprocess will be replaced by
mdox tranform
.