Skip to content

Reorganize documentation and project governance - #137

Merged
miuchan merged 1 commit into
mainfrom
codex/documentation-information-architecture
Aug 22, 2026
Merged

Reorganize documentation and project governance#137
miuchan merged 1 commit into
mainfrom
codex/documentation-information-architecture

Conversation

@miuchan

@miuchan miuchan commented Aug 22, 2026

Copy link
Copy Markdown
Owner

Summary

  • rewrite the repository and locale landing pages around current verified capabilities, the active frontier, quick start, task-based navigation, and honest maturity/licensing boundaries
  • reorganize the multilingual documentation hub into a goal-oriented map while preserving canonical machine-facing research records
  • add current snapshots to all research-status pages and update architecture/scope pages with the generated-hammock Dwyer--Kan and terminating-reduction results
  • expand the contribution workflow with proof, model, documentation, validation, and PR policies
  • add canonical and four-language governance/security policies
  • add pull-request, bug-report, and research-proposal GitHub templates
  • extend documentation validation to require governance/security mirrors and canonical project-health files

Verification

  • parsed every issue-form YAML file successfully
  • ./scripts/check-doc-locales.sh
  • ./scripts/check-source-quality.sh
  • git diff --check
  • ./scripts/quality-gate.sh (3664 Lean targets, declaration lint, executable examples, and axiom allowlist all passed)

Important boundary

No open-source license is present or selected. This change makes that boundary prominent and does not claim that public source visibility grants reuse rights. Choosing a license remains an explicit maintainer/legal decision outside this documentation reorganization.

@miuchan
miuchan marked this pull request as ready for review August 22, 2026 14:42
@miuchan
miuchan merged commit fb3d54a into main Aug 22, 2026
1 check passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 26624a8d27

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

- [ ] New flagship declarations added to AxiomChecks and `AXIOMS.md`
- [ ] Remaining research is recorded without weakening the stated goal

See [CONTRIBUTING.md](../CONTRIBUTING.md) for the complete merge policy.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Use a stable link to the contributing guide

When this template is copied into a new pull request, the Markdown is rendered in the PR body context rather than from .github/PULL_REQUEST_TEMPLATE.md, so ../CONTRIBUTING.md no longer resolves relative to the template directory and leads away from the repository's root guide. Use a repository-root or absolute GitHub URL so every generated PR retains a working policy link.

Useful? React with 👍 / 👎.

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.

1 participant