Angela White Johanna Carll Jessica Crouch Sarit Hand
The following is a list of items to take into consideration while building out a Style Guide. Feel free to add notes or make comments on any of it.
Layout
Start each page with a narrative?
Followed by step by step instructions in list format?
End with use case scenarios? Should we have? If so, how many variations?
Info boxes
Linking to glossary
What needs an entry in the glossary?
How to return from the glossary
How to use abbreviations.
Font
style
Font size
Paragraph format
Line spacing
Indenting vs hanging
Bullets vs numbering
Formatting headings: Page title, section titles
Formatting screen shots
Where to place
Before or after a section?
Immediately following the descriptive text? i.e. if we do step by step instructions would we want a screen shot for each step?
Use borderlines around the image to make it more visible
How much to crop out (if you crop out too much, the image loses context.)
Using arrows to point to specific items on the image?
Style
Size
color
Video tutorials
Embedded on page or link to?
Should there be a video demo per page to illustrate the text?
Time limit?
Pagination and when to create a new page
Navigating through the pages