Skip to content

docs: add ARCHITECTURE, ROADMAP, CITATION, FUNDING, editorconfig#62

Open
kingchenc wants to merge 1 commit into
mainfrom
docs/governance-files
Open

docs: add ARCHITECTURE, ROADMAP, CITATION, FUNDING, editorconfig#62
kingchenc wants to merge 1 commit into
mainfrom
docs/governance-files

Conversation

@kingchenc
Copy link
Copy Markdown
Owner

Summary

Adds five governance + onboarding files that close the no high-level documentation outside of README gap. Touches no Rust source, no CI workflows, no behaviour. Additive only.

File Purpose
ARCHITECTURE.md Workspace layout, Indicator trait contract, per-indicator file conventions, numerical-stability notes, cross-crate flow diagram, navigation cheatsheet, deliberate non-goals, performance characteristics, stability commitments
ROADMAP.md North star, 0.3 / 0.4 / 0.5 release windows, indicator-wishlist intake rules, explicit non-goals, versioning policy
CITATION.cff GitHub renders as Cite this repository button — enables academic adoption
.github/FUNDING.yml Surfaces Sponsor button on the repo page
.editorconfig Normalises indent/EOL across IDEs (Rust/Python 4 spaces, JS/TS/JSON/YAML/MD 2 spaces, Makefile tabs)

Why

Filling out Section A of the improvements TODO (governance polish). Closes part of Section A.2 and E.2/E.3/E.4/E.15/E.16 from the project analysis.

Merge order

Already-open companion PRs are #59 (org migration), #60 (family-api), #61 (release 0.2.8). This PR is independent of all three — no shared files, no conflicts. Recommended merge order remains #59#60#61 → this PR after the org transfer on GitHub side.

URLs in ROADMAP.md and CITATION.cff reference the post-transfer wickra-lib/wickra org so files stay valid once #59 lands. They will 404 only during the brief window between this PR's merge and the GitHub-side org transfer.

CI expectation

29 standard checks (sync-metadata.yml from #59 not present here yet). All must be green.

Five governance + onboarding files that collectively close the
"no high-level documentation outside of README" gap.

- ARCHITECTURE.md: workspace layout, Indicator trait contract,
  per-indicator file conventions, numerical-stability notes,
  cross-crate flow diagram, navigation cheatsheet, deliberate
  non-goals, performance characteristics, stability commitments.
- ROADMAP.md: north star, 0.3 / 0.4 / 0.5 release windows,
  indicator-wishlist intake rules, explicit non-goals, versioning policy.
- CITATION.cff: GitHub-renders as "Cite this repository" button;
  enables academic adoption.
- .github/FUNDING.yml: surfaces Sponsor button on the repo page.
- .editorconfig: normalises indent/EOL across IDEs (Rust/Python 4 spaces,
  JS/TS/JSON/YAML/MD 2 spaces, Makefile tabs).

Touches no Rust source, no CI workflows, no behaviour. Additive only.
URLs in ROADMAP/CITATION already reference the post-transfer
`wickra-lib/wickra` org so the files stay valid once the org migration
in PR #59 lands; merge this PR only after #59 to keep main consistent.
@codecov
Copy link
Copy Markdown

codecov Bot commented May 27, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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