You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This issue kind of deals with three different problems, but if we're going to have to touch every repo that contains MD files again, it makes sense to deal with all three at once:
There are some asciidoc-style links that were not converted to V3-style links. For example: https://www.elastic.co/guide/en/cloud/current/ec-add-user-settings.html[user setting] They seem to often be surrounded by parentheses, but can likely be found mostly easily by searching for ".html[" in *.md files. They should instead be updated to use the following format:
https://docs-v3-preview.elastic.dev/elastic/docs-builder/tree/main/syntax/links.
Some of these broken links exist in the substitutions defined in the docset.yml files. Since all of our docset.yml files currently have the same list of substitutions, I think it means every repo that we've migrated docs into will be affected.
Per chat with @colleenmcginnis and @Mpdreamz if we're touching all those files anyway, it's a good time to remove all the variables that are unused in each repo. That way we don't have to unnecessarily update multiple docset.yml files in the future for substitutions that aren't even used there.
Resources
Please check off the repo in this list if you've confirmed that either the problems don't exist in that repo or that they're fixed (e.g. by adding commits to existing PRs in some cases)
Description
This issue kind of deals with three different problems, but if we're going to have to touch every repo that contains MD files again, it makes sense to deal with all three at once:
https://www.elastic.co/guide/en/cloud/current/ec-add-user-settings.html[user setting]
They seem to often be surrounded by parentheses, but can likely be found mostly easily by searching for ".html[" in *.md files. They should instead be updated to use the following format:https://docs-v3-preview.elastic.dev/elastic/docs-builder/tree/main/syntax/links.
docset.yml
files. Since all of our docset.yml files currently have the same list of substitutions, I think it means every repo that we've migrated docs into will be affected.docset.yml
files in the future for substitutions that aren't even used there.Resources
Please check off the repo in this list if you've confirmed that either the problems don't exist in that repo or that they're fixed (e.g. by adding commits to existing PRs in some cases)
NOTE: Warnings about unused substitutions were added per elastic/docs-builder#762 but there might be a bug in that per elastic/docs-builder#779
Which documentation set does this change impact?
Elastic On-Prem and Cloud (all)
Feature differences
N/A
What release is this request related to?
9.0
Collaboration model
The documentation team
Point of contact.
N/A
The text was updated successfully, but these errors were encountered: