Skip to content

docs(security): fix role-guide links and skills path in onboarding#896

Open
FenjuFu wants to merge 1 commit into
apache:mainfrom
FenjuFu:docs/onboarding-roles-links
Open

docs(security): fix role-guide links and skills path in onboarding#896
FenjuFu wants to merge 1 commit into
apache:mainfrom
FenjuFu:docs/onboarding-roles-links

Conversation

@FenjuFu

@FenjuFu FenjuFu commented Jul 16, 2026

Copy link
Copy Markdown

Summary

  • Point the three role-info cross-references in docs/security/new-members-onboarding.md at roles.md instead of the top-level README.md — the README has no role sections; the role guides and their step ranges (triager 1–6, remediation developer 7–11, release manager 12–15) live in docs/security/roles.md.
  • Replace the retired .claude/skills/ display path with the canonical .agents/skills/ in the "Using the agent skills" section (link target unchanged).

Fixes #870

Test plan

  • Verified the root README's section list contains no role sections, while docs/security/roles.md is organised exactly by the three roles with their step ranges.
  • Verified roles.md sits in the same directory as the onboarding doc, so the relative links resolve; .agents/skills/ exists at the repo root. Link targets are unchanged or same-directory, so lychee should stay green.

Why: the onboarding guide sent new members to the top-level README
for role information, but the README has no role sections - the role
guides and their step ranges live in docs/security/roles.md. It also
displayed the retired .claude/skills/ path where the framework's
canonical path is .agents/skills/.

Fixes apache#870

Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/security/new-members-onboarding.md: stale .claude/skills/ reference + wrong link target

1 participant