Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[guide] docs/metrics/index.md names retired 'Import reference architectures' workflow as the metrics refresh path

Closed Beginner friendly
  • Is something wrong?
#1,537 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

A pull request for this has already been merged.

  • #1538 by @hivecommons-hive — merged

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
70/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions, markdown
Domain
documentation

Research direction

Open docs/metrics/index.md around lines 29-30, where the sentence splits across a line break and names the retired "Import reference architectures" workflow. Confirm the real workflow in .github/workflows/refresh-metrics.yml (name: Refresh metrics, workflow_dispatch) and check CONTRIBUTING.md for the wording already fixed in #1530. Done when the sentence names the Refresh metrics workflow and validate:metrics, and no reference to the old name remains in that file.

Written by the indexing model from the issue text.

Description

agent/guide documentation hive/covered-by-pr hive/hosted-available-lke648397-260827-5n31

Documentation Gap

docs/metrics/index.md:29-30 tells readers:

Metrics are refreshed on demand from public CNCF sources via the "Import
reference architectures" workflow and validated before each site build.

No workflow named Import reference architectures exists in .github/workflows/. That name was retired; the same stale reference in CONTRIBUTING.md was fixed by #1530, but this second occurrence (in the rendered /metrics docs page) was missed — it is invisible to single-line grep because the phrase is split across a line break.

The actual on-demand refresh path is the Refresh metrics workflow (.github/workflows/refresh-metrics.yml, workflow_dispatch only), which runs collect:metrics/validate:metrics and friends. The architectures submission flow is a different workflow (architecture-submission.yml) and has nothing to do with metrics.

Recommendation

Rewrite the sentence to name the real workflow, e.g.:

Metrics are refreshed on demand from public CNCF sources via the Refresh metrics workflow (.github/workflows/refresh-metrics.yml, run from the Actions tab) and validated with validate:metrics before each site build.

Evidence

  • grep -n "Import" docs/metrics/index.md → lines 29-30 (phrase split across the break).
  • ls .github/workflows/ → no import-reference-architectures.yml; refresh-metrics.yml has name: Refresh metrics and on: workflow_dispatch.
  • CONTRIBUTING.md already documents the "Refresh metrics" workflow (fixed in #1530).

Filed by guide agent (ACMM L5 — hold-gated mode)

🐝 Hive Agent: guide | Instance: hosted-available-lke648397-260827-5n31 | SHA: unknown

— hive: agent=guide backend=copilot model=kimi-k3 copilot=1.0.88

Dominant language
JavaScript
Stars
0
Forks
2
Avg merge
13h 43m
Merged PRs (30d)
600

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from cncf/endusers

All issues in cncf/endusers

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.