Skip to content

docs(economics): format token counts as K/M notation#796

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/mode-economics-km-formatting
Jul 9, 2026
Merged

docs(economics): format token counts as K/M notation#796
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/mode-economics-km-formatting

Conversation

@potiuk

@potiuk potiuk commented Jul 9, 2026

Copy link
Copy Markdown
Member

What & why

Extracts the readability-only slice of #750: reformats every token count on
docs/mode-economics.md to K/M notation (30,00030K,
1,500,0001.5M) and adds a one-line key explaining the convention, so the
per-mode tables and rules-of-thumb read at a glance.

The voluntary opt-in usage-data-sharing program from #750 (the new sections
in AGENTS.md, projects/_template/project.md, and the "Sharing your usage
data" section of mode-economics.md) is intentionally not included here — it
belongs in its own change.

Scope

  • Only docs/mode-economics.md is touched.
  • No headings changed → TOC unchanged (doctoc clean).

Validation

  • pre-commit on the changed file: doctoc, SPDX, markdownlint, typos,
    lychee (link check) all pass.

Generated-by: Claude Code (Opus 4.8)

Reformat every token count on docs/mode-economics.md to K/M notation
(30,000 -> 30K, 1,500,000 -> 1.5M) and add a one-line key explaining the
convention, so the per-mode tables and rules-of-thumb read at a glance.

Readability-only slice extracted from apache#750; the voluntary opt-in
usage-data-sharing program from that PR is intentionally left out.
@potiuk potiuk merged commit 25e8768 into apache:main Jul 9, 2026
9 checks passed
potiuk pushed a commit to potiuk/magpie that referenced this pull request Jul 9, 2026
Adds a voluntary, opt-in program for adopters to contribute anonymised
token-economics data that feeds docs/mode-economics.md and the long-term
ASF inference-endpoint capacity model — not any vendor.

- docs/mode-economics.md: new "Sharing your usage data (opt-in)" section —
  how to opt in, the session-end question, submission as a PR to
  apache/magpie-economics, the payload contents, and the privacy exclusions.
- AGENTS.md: new cross-cutting rule "Voluntary usage-data sharing (opt-in)":
  only when the adopter has opted in does a skill session end by asking whether
  to submit; never auto-submits; the payload carries no PII and no
  subscription/billing data.
- projects/_template/project.md: new economics_data_sharing key (default off).

The K/M number-formatting readability changes that originally rode with this PR
were split into their own PR (apache#796, now merged), so this is opt-in-only.
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