Andrew FrahnandClaude Opus 5.5
6cbc0eb5a9
- brand.toml is the only place the product name lives; every crate and app
reads it through dac-brand (env vars with legacy fallback, settings folder
with copy-only migration, default library, preset extensions, i18n {app})
- cargo xtask brand check|test, run|install|package, docs, rename-crates,
deny and immich; packaging files are templates rendered from brand.toml
- icons regenerated from brand/icon.svg; upstream branding removed
- MIT licence (segment and fetch stay Apache-2.0); cargo deny licence policy
- clean-room rules in AGENTS.md/CLAUDE.md; docs/upstream-merge.md
- plan/ rebuilt and committed; parity tracker reopens Classic rows, adds
PLAN.md section 2 rows and the IMM Immich section; plan/immich.md and a
pinned Immich test server
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
3.0 KiB
Contributors in the About window
Names in angle brackets (
<app>,<binary>,<cli>,<PREFIX>,<settings_dir>, …) are the values set inbrand.toml; see the README.
About ▸ Contributors credits everyone who contributed to the app, and About ▸ Models credits
the AI models named in Co-Authored-By trailers. This follows the shared craftrules standard
standards/contributors.md;
this page is the local copy of the decision.
Decision
- Two files, both compiled into the binary by the UI crate's
build.rs(nothing is read from disk or the network at run time; the web build has them too):contributors/contributors.json: commit stats per GitHub username. Generated bycraftrules/scripts/contributors.py; never hand-edit.contributors/people.toml: the names people chose for themselves. Each contributor adds only their own entry, in their own PR.
- Each contributor gets one line: GitHub username (always), display name (opt-in, or their synced GitHub profile name), real name (only if they told us), merged PRs, commits, lines added, lines deleted, binary assets added, binary assets removed, first and last commit date.
- The list is shown as a grab bag (names flowing as text) or a table, in the same order. It
sorts by name, PRs, commits, lines added, lines deleted, line delta, binary assets added/removed,
first or last commit date. The name toggle cycles Username → Display name → Real name; a
missing name falls back to
@username. Alphabetical sorting is case-insensitive and ignores the@.
In the app
- The About dialog (
crates/ui-egui/src/panels/dialogs.rs, Help ▸ About ) has the tabs About · Contributors · Models; the control channel can switch them withui.clickWidget {"id": "button:aboutTab-contributors"}(-about,-models), and the list view withbutton:creditsGrabBag/button:creditsTable.
Credit yourself
Add your entry to contributors/people.toml in a PR you commit yourself (every field optional):
[people.your-github-username]
real_name = "Your Name"
display_name = "Nickname"
sync_github_name = true # use the name on your public GitHub profile as display name
or, with craftrules checked out next to craft-apps/:
python3 ../../craftrules/scripts/contributors.py --add-me . --real-name "Your Name" --sync-github-name
Names show after the next refresh: the script checks that each entry was committed by its own
user (or by a maintainer with a consent_source). Delete your entry to remove your names.
Refreshing (maintainers)
python3 ../../craftrules/scripts/contributors.py . # regenerate + verify; needs git, Python 3.11+, gh
python3 ../../craftrules/scripts/contributors.py --check . # verify people.toml only
Commit the updated contributors/contributors.json. Git author names and emails are never recorded.