Skip to content

docs: keep the card the mark is cut from, and hand the shape upstream - #197

Merged
isaacslee merged 1 commit into
mainfrom
docs/keep-the-mark-source
Aug 27, 2026
Merged

isaacslee merged 1 commit into
mainfrom
docs/keep-the-mark-source

Conversation

@isaacslee

Copy link
Copy Markdown
Member

Summary

Adds the source card mark.png is built from, a short note beside the assets,
and points ADR-0005's shape rule at the organisation copy that now owns it.

Why

The mark's shape was written down in this repository's decision record, because
this is where it was decided. It is not where it applies: swarea/mori-lens
wanted a mark, did not find the rule, and shipped one at 180×220 with no tile,
displayed in a 96×96 box.

That rule and a generator now live at
swarea/.github docs/repository-mark.md.
ADR-0005 keeps the part that is genuinely this project's — why blue, when the
organisation is also blue — and hands the shape upstream.

mark-source.png is here for a plainer reason. The card set is in no repository
and moved during the session it was being read from. Without the card, this
repository can display its mark and cannot remake it — at another size, or if the
ground changes again, which it has three times.

How it was verified

  • npm run check — 27 checks pass, including preview palette (2 generators),
    which is back to two: the generator drafted here has moved to the organisation
    repository, where it is not coupled to this project's tokens.
  • mark-source.png opens as 1254×1254 RGB, the card as the set ships it.
  • The rule and the mark still agree: mark.png is 512×512, ground #f7f7f6,
    and its alpha channel is identical pixel for pixel to the mark rebuilt for
    mori-lens under the same formula.

Cost

216 KB for the source card. It buys the ability to regenerate a shipped file from
its input.

Not here

The other 111 cards in the set. Four are in use across the organisation and the
rest are candidates nobody chose — a library with no diff worth reading, which is
a backup problem rather than a version control one.

- add `mark-source.png`, the card `mark.png` is built from, so the mark can be
  rebuilt here rather than from a folder that is in no repository and moved
  once while it was being read from
- add a note beside the assets saying what each file is and which of them is
  generated from which
- ADR-0005 recorded the shape because this is where it was decided, not where
  it applies. the next repository to want a mark did not find it and built one
  at 180x220 with no tile. the rule and a generator now live in the
  organisation defaults, and what stays here is why this project chose its
  colour
- verification: 27 checks pass
Copilot AI lite review requested due to automatic review settings August 27, 2026 04:31

Copilot AI 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@isaacslee
isaacslee merged commit ee39db7 into main Aug 27, 2026
1 check passed
@isaacslee
isaacslee deleted the docs/keep-the-mark-source branch August 27, 2026 04:32
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.

2 participants