Details
-
Task
-
Resolution: Fixed
-
Neutral
-
None
-
None
-
None
-
-
Empty show more show less
-
Empty show more show less
Description
The screenshots in development environment setup instructions still look awful. Tops are cut off and there is unrelated stuff at the bottom and sides. In some images it's unclear what is being illustrated and some are just not necessary for a competent person who is about to develop code.
- Take new screenshots. Follow Documentation Style Guide
- When shooting an OS dialog, capture the whole dialog. Don't cut off at the top. Don't leave extra stuff on the sides and bottom. See borders.png attached.
- When it's unclear what the reader should be doing in the screenshot, use annotations and illustration. Use clean-looking arrows and circles that are hand-drawn style. Get an application that can do these. It should be part of a technical writer's toolset. See annotate.png attached. Use Magnolia corporate color scheme.
- When shooting a part of a page, leave some white space around the element. See e.g. Field sets
- Store at full resolution. Don't zoom out. Images get fuzzy. Bad example: starting-tomcat.png
Checklists
Acceptance criteria