Reconcile with policymaker; surface the four canonical term sets#12
Open
yesnet0 wants to merge 1 commit into
Open
Reconcile with policymaker; surface the four canonical term sets#12yesnet0 wants to merge 1 commit into
yesnet0 wants to merge 1 commit into
Conversation
Restructure dioterms so the four canonical templates served by
policymaker.disclose.io are obvious and one-click-discoverable in the
repo layout, adding the two templates that were previously missing
(plain VDP without CVD; standalone full Safe Harbor) and mirroring all
three policymaker locales (en-US, ar, np-NP) for each.
Layout:
- terms/{vdp,vdp-with-cvd,safe-harbor,simple-safe-harbor}/{en-US,ar,np-NP}.md
- mirrors policymaker gh-pages templates 1:1 (byte-identical)
- bbp/en-US.md
- preserved as a fifth canonical; policymaker does not (yet) carry it
- terms/README.md, terms/languages.json
- explain the layout and policymaker relationship; declare supported locales
- regional/, maturity/
- unchanged
- archive/core-terms/
- modular section fragments folder relocated here
Moves (blame preserved via git mv):
- core-terms-vdp.md -> terms/vdp-with-cvd/en-US.md
(the existing file already used {{disclosure_window}}, so it is the
with-CVD variant; the plain VDP is newly added from policymaker)
- core-terms-bbp.md -> bbp/en-US.md
- simple-safeharbor/simple-safe-harbor.md -> terms/simple-safe-harbor/en-US.md
- core-terms/ -> archive/core-terms/
Removed:
- practices/ - the operational-playbook pillar. Stubs were never populated
(all "Coming soon"); that material belongs on the disclose.io website,
not in the terms repo. Git history preserves the stubs.
Updated: README, CHANGELOG, CODEOWNERS, metadata.yaml to reflect the new
layout. Policymaker is treated as authoritative for term prose; dioterms
is now re-aligned byte-for-byte so future edits can flow dioterms ->
policymaker rather than the other way around.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
gh-pagestemplates:terms/vdp/,terms/vdp-with-cvd/,terms/safe-harbor/,terms/simple-safe-harbor/— each inen-US,ar,np-NP.bbp/en-US.mdas a fifth canonical (not part of the policymaker-aligned four; preserved for community use).core-terms/fragments folder toarchive/core-terms/to preserve history while surfacing the four canonicals at the top level./practices/— the stubs never populated; operational-playbook content belongs on the disclose.io website.git mvto preserve blame.Layout after merge
Coordination
Paired with disclose/website PR that bumps the submodule pointer and updates
scripts/preprocess-framework.js. Merge this first.Policymaker is treated as authoritative for term prose drift; dioterms is re-aligned where the two diverged. Future edits to the four canonicals should happen here first, with policymaker picking them up on its next release.
Test plan
terms/languages.jsoncontent matches policymakerdisclose/policymaker@gh-pages:templates/disclose-io-<template>/<locale>.mdcore-terms-vdp.md → terms/vdp-with-cvd/en-US.md,core-terms-bbp.md → bbp/en-US.md,simple-safeharbor/simple-safe-harbor.md → terms/simple-safe-harbor/en-US.md)archive/core-terms/carries blame from the originalcore-terms/folder🤖 Generated with Claude Code