Skip to content

Conversation

DaveCTurner
Copy link
Contributor

@DaveCTurner DaveCTurner commented Sep 27, 2024

  • Forbid ephemeral _auto_gen.html and page.html#_auto_gen links.
  • Remove dangling/unused BOOTSTRAP_CHECK_G1GC link.
  • Separate test suite into individual tests.

- 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.
@DaveCTurner DaveCTurner added :Core/Infra/Core Core issues without another label Supportability Improve our (devs, SREs, support eng, users) ability to troubleshoot/self-service product better. v8.16.0 v9.0.0 labels Sep 27, 2024
Copy link
Contributor

Documentation preview:

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-core-infra (Team:Core/Infra)

@DaveCTurner
Copy link
Contributor Author

Note that we're not currently validating these links anyway, see elastic/docs#2656

@rjernst
Copy link
Member

rjernst commented Sep 30, 2024

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.

@DaveCTurner
Copy link
Contributor Author

Why yaml?

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.

@DaveCTurner DaveCTurner requested a review from rjernst October 1, 2024 06:44
Copy link
Member

@rjernst rjernst left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@DaveCTurner DaveCTurner merged commit 69fffdf into elastic:main Oct 1, 2024
16 checks passed
@DaveCTurner DaveCTurner deleted the 2024/09/27/reference-docs-links-cleanup branch October 1, 2024 12:44
DaveCTurner added a commit to DaveCTurner/elasticsearch that referenced this pull request Oct 1, 2024
- Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links.
- Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link.
- Separate test suite into individual tests.
@elasticsearchmachine
Copy link
Collaborator

💚 Backport successful

Status Branch Result
8.x

elasticsearchmachine pushed a commit that referenced this pull request Oct 1, 2024
- Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links.
- Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link.
- Separate test suite into individual tests.
matthewabbott pushed a commit to matthewabbott/elasticsearch that referenced this pull request Oct 4, 2024
- Forbid ephemeral `_auto_gen.html` and `page.html#_auto_gen` links.
- Remove dangling/unused `BOOTSTRAP_CHECK_G1GC` link.
- Separate test suite into individual tests.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

:Core/Infra/Core Core issues without another label >non-issue Supportability Improve our (devs, SREs, support eng, users) ability to troubleshoot/self-service product better. Team:Core/Infra Meta label for core/infra team v8.16.0 v9.0.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants