-
Notifications
You must be signed in to change notification settings - Fork 25.5k
Misc ReferenceDocs
improvements
#113667
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
Misc ReferenceDocs
improvements
#113667
Conversation
- Migrate link defs to YAML, mainly to reduce noise when adding links. - Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links. - Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link.
Documentation preview: |
Pinging @elastic/es-core-infra (Team:Core/Infra) |
Note that we're not currently validating these links anyway, see elastic/docs#2656 |
Why yaml? I had actually made a change to the docs build to support tab delimited txt, but lost track of the corresponding change in ES. My intention there was to be able to move reference docs into the core/lib, so it could be used in other libs. As it is now, it can't because it requires xcontent. |
Only because it is easy to parse correctly and has no interspersed separators (i.e. no trailing commas). But I can move this to an XContent-free format too if you'd prefer. I'll remove the format change from this PR and open a follow-up. |
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.
LGTM
- Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links. - Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link. - Separate test suite into individual tests.
💚 Backport successful
|
- Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links. - Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link. - Separate test suite into individual tests.
- Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links. - Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link. - Separate test suite into individual tests.
_auto_gen.html
andpage.html#_auto_gen
links.BOOTSTRAP_CHECK_G1GC
link.