Closed lmolkova closed 1 month ago
DocFx v3 is no longer available and not intended to be used externally.
The feature it provided that we don't have from other tooling is cross-file anchor reference check, see https://github.com/open-telemetry/semantic-conventions/issues/1009 for the details. It seems there is no popular (or even not popular) replacement for it.
DocFx v2 only check anchors within the same file which markdownlint does as well.
Related: https://github.com/open-telemetry/semantic-conventions/pull/1008
Closes #4026.
This PR removes docfx since v2 does not provide additional value. We'll need to find a different solution for relative anchor checks.
CHANGELOG.md
spec-compliance-matrix.md
Let's give a heads up to people on today's Spec call, and otherwise let's merge this fast.
DocFx v3 is no longer available and not intended to be used externally.
The feature it provided that we don't have from other tooling is cross-file anchor reference check, see https://github.com/open-telemetry/semantic-conventions/issues/1009 for the details. It seems there is no popular (or even not popular) replacement for it.
DocFx v2 only check anchors within the same file which markdownlint does as well.
Related: https://github.com/open-telemetry/semantic-conventions/pull/1008
Closes #4026.
Changes
This PR removes docfx since v2 does not provide additional value. We'll need to find a different solution for relative anchor checks.
CHANGELOG.md
file updated for non-trivial changesspec-compliance-matrix.md
updated if necessary