elastic/docs-content

[Chore] Review `docset.yml` for subs that can be removed

开放

#3,536 创建于 2025年10月17日

 (7 条评论) (3 个反应) (0 位负责人) (251 个派生)auto 404
Confidence: 1Effort: 0.1Impact: 1Reach: 1chorecross-teamgood first issuegood-for-ai

仓库指标

星标
 (46 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

In my opinion, subs aren't as helpful if we don't use them consistently. In https://github.com/elastic/elastic-docs-vscode/pull/2, we added inline warnings when an author hard-codes the value of a sub instead of using the sub key, which provides a light-touch way to encourage consistent use of subs and weed out unnecessary subs without introducing a bunch of errors.

However, there are some subs that are likely unnecessary, like api-examples-title: Examples, that should be removed from docset.yml. We should go through repo-level subs in this repo (and others) and eliminate any unnecessary subs.

cc @theletterf @florent-leborgne

贡献者指南