Skip to content

docs: draw a new social preview from a real run - #12

Merged
awss1i merged 2 commits into
mainfrom
social-preview-terminal
Oct 31, 2026
Merged

awss1i merged 2 commits into
mainfrom
social-preview-terminal

Conversation

@awss1i

@awss1i awss1i commented Oct 31, 2026 •

Copy link
Copy Markdown
Owner

What This Changes

The image GitHub shows in links to this repo was a dark card with the icon, the name and the install line. This replaces it with a card in a different, cleaner style. A gritty paper panel on the left has the name, the language and the repo description, and a tilted ink panel on the right has the first five cases of a real run of assay ./reorder, with failures in orange.

docs/social.py draws the card from that run in the benchmark, the same way docs/hero.py draws run.svg. The three fonts it uses (Dela Gothic One, Shippori Mincho B1 and JetBrains Mono) are in docs/fonts with their OFL licence, so the card draws the same on any machine. The script saves the PNG at 1280x640, which keeps it at about 835 KB, under GitHub's 1 MB limit for a social preview.

Kind

  • Bug fix
  • False-alarm fix
  • Benchmark improvement
  • Feature
  • Plugin or harness support
  • Docs
  • Misc

Tests

python docs/social.py docs/social-preview.png draws the committed image. Nothing outside docs/ changes.

Benchmarks

Not needed. The change doesn't touch a rule or any file in bench/.

AI use

  • AI-written or AI-assisted, and I've read every line.

…om style

The card now shows the name, the language and the repo description on a gritty paper panel, beside a tilted ink panel with the first five cases of the reorder run. The three fonts it uses are in docs/fonts with their OFL licence, so the card draws the same on any machine.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Oct 31, 2026
@awss1i
awss1i merged commit 2e31098 into main Oct 31, 2026
8 checks passed
@awss1i
awss1i deleted the social-preview-terminal branch October 31, 2026 06:13
@awss1i awss1i changed the title docs: draw the social preview from a real run, in the awssalmubarak.com style docs: draw a new social preview from a real run Nov 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant