Sharing6 min read
How to take a terminal screenshot that looks professional
Capture a terminal window on macOS, Windows and Linux, clean up the prompt and output, and turn commands into sharp, readable images.
Guides
Practical write-ups on presenting technical work clearly — from code screenshots and README files to bug reports, API docs and keeping secrets out of what you share.
Sharing6 min read
Code screenshot best practices: how to share code people actually read
How much code to show, line length, font size, contrast, captions and alt text: a practical checklist for code images on X, LinkedIn, slides and blogs.
Security6 min read
How to redact API keys and secrets in screenshots before you share them
Where API keys, tokens and personal data hide in terminals, logs, requests and .env files, how to redact them safely, and what to do after a leak.
Workflow6 min read
How to write a good bug report (with logs and stack traces that help)
Write bug reports maintainers can act on: a searchable title, minimal reproduction, expected vs actual behavior, the right logs, and a copyable template.
Documentation6 min read
API documentation examples: how to write requests, responses and errors developers trust
Write API docs examples developers trust: complete requests, realistic data, full responses, documented error codes, and examples that stay correct.
Documentation6 min read
How to write a good README: a structure that explains your project in 30 seconds
What to put in a README and in what order: a one-line pitch, a visual, a working quick start, configuration, project structure, plus a template.
Workflow6 min read
How to read a git diff — and write commit messages that explain it
Read git diff output line by line, use flags that make changes easier to review, write commit messages that explain why, and share diffs clearly.
Workflow6 min read
SQL formatting best practices: write queries anyone can read
Practical SQL style rules — one clause per line, explicit joins and columns, CTEs over nested subqueries, clear aliases — plus how to present schemas.
Documentation6 min read
Alt text for code images: how to make code screenshots accessible
How to write alt text for code and terminal screenshots, meet WCAG contrast guidelines, and decide when a code block beats an image.
Design5 min read
The best fonts and themes for code screenshots
How to pick a monospace font and syntax theme for code images: legibility, ligatures, dark vs light, and the best pairings for posts, docs and slides.
Design5 min read
PNG vs SVG for code images: which format should you export?
PNG vs SVG for code screenshots: sharpness, file size, pixel ratio and platform support, and which format to use for social media, docs, slides and print.