Before uploading
Make every image explain something.
A strong image supports a specific technical point. Prefer clear diagrams, carefully redacted captures, and platform illustrations over decorative media that adds visual weight without evidence.
Good candidates
Useful media is legible at documentation width and directly connected to the surrounding text.
- Protocol diagrams showing fields, flows, or relationships.
- Terminal or tool output with credentials and private identifiers removed.
- Platform-specific screenshots that clarify an installation or configuration step.
- Original figures with a short explanation of what readers should notice.
Review questions
Before submitting, check the image as carefully as you would check a command example.
- Can the important labels be read on a small screen?
- Is the image necessary for the page rather than merely attractive?
- Do you have permission to share the image and its underlying material?
- Could it expose a private network, user, token, or internal hostname?