Skip to content

certs: expand the contributions guide#521

Merged
mattaereal merged 2 commits into
security-alliance:developfrom
ipatka:certs-contribution-guide
Jun 21, 2026
Merged

certs: expand the contributions guide#521
mattaereal merged 2 commits into
security-alliance:developfrom
ipatka:certs-contribution-guide

Conversation

@ipatka

@ipatka ipatka commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

Expands the thin certs/contributions.mdx into a lightweight guide for contributing to the certifications.

What it documents

  • This repo is the source of truth for controls; each cert's controls live in the cert: block of its page.
  • What you can contribute: improve a control, add a control to an existing cert, or propose a new cert (issue first).
  • Categories are fixed; new controls are added within existing categories.
  • Final decisions rest with the SEAL Certifications initiative lead.
  • Lightweight release process: stable control IDs (renumbers called out for workbook re-mapping), changes batched into named releases tracked in the changelog. Releases are named after seal species, alphabetically (Baikal, Bearded, Crabeater, …).

🤖 Generated with Claude Code

@ipatka ipatka force-pushed the certs-contribution-guide branch 2 times, most recently from 4656475 to c9ebfb8 Compare June 19, 2026 17:18
@ipatka ipatka requested a review from DicksonWu654 June 19, 2026 17:19
Make explicit that the frameworks repo is the source of truth for
controls, that categories are fixed while new controls can be added,
and that final decisions rest with the certs initiative lead. Document
the lightweight release process: stable control IDs, batched named
releases (seal-species theme) tracked in the changelog.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ipatka ipatka force-pushed the certs-contribution-guide branch from c9ebfb8 to 7efc3ea Compare June 19, 2026 17:22
@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
frameworks ✅ Ready (View Log) Visit Preview 81ec0cb

Comment thread docs/pages/certs/contributions.mdx

@frameworks-volunteer frameworks-volunteer left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Model: z-ai/glm-5.1 Reasoning: medium Provider: openrouter

Security: clean -- no secrets, no injection vectors, no suspicious content.

QA: mostly clean. One minor note:

  • The description frontmatter is ~187 chars, above the 140-160 guideline from AGENTS.md. Consider trimming, e.g. dropping "The frameworks repo is the source of truth, and changes ship in named releases." (that detail is covered in the body).

Everything else checks out:

  • All three internal links resolve (/certs/sfc-multisig-ops, /contribute/contributing, /certs/changelog)
  • isaac is registered in contributors.json (steward role)
  • version field claim in the new content is accurate (verified on sfc-multisig-ops.mdx)
  • Tags and contributors frontmatter are valid
  • No leftover debug content or placeholders
  • Content is well-structured and matches the PR description

Approved with the minor description-length note. Not blocking.

Added contact information for contributions and clarified feedback request.
@mattaereal mattaereal merged commit 238c773 into security-alliance:develop Jun 21, 2026
3 checks passed
AllyPry pushed a commit to AllyPry/frameworks that referenced this pull request Jun 22, 2026
* certs: expand the contributions guide

Make explicit that the frameworks repo is the source of truth for
controls, that categories are fixed while new controls can be added,
and that final decisions rest with the certs initiative lead. Document
the lightweight release process: stable control IDs, batched named
releases (seal-species theme) tracked in the changelog.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Enhance contributions section with contact details

Added contact information for contributions and clarified feedback request.

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Matías Aereal Aeón <388605+mattaereal@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.

4 participants