Use Context
Content Components
Look and Feel
Sample Pages
Anchor | ||||
---|---|---|---|---|
|
It walks readers through a tool by following a real-life use case.
Anchor | ||||
---|---|---|---|---|
|
Purpose | Style | Sample text | |||
---|---|---|---|---|---|
title | states the project to be accomplished. | A noun | names the tool that the walkthrough is for and then identifies it as a walkthrough. | name of tool + walkthrough | WordPress WalkthroughE-Portfolio |
end result | describes the final project and the content it will contain. | The end result is a longer sentence fragment, general a noun. Title this section "End Result:". | End Result:
An e-portfolio with an “About” page and a CV.
| ||
requirements | lists the elements the user should have before starting the project. | Use an unordered list. Title this section "Requirements:" |
Requirements: • A CV in pdf form • A WordPress site
| ||
directions |
lists the broad steps needed to accomplish the project. Each direction will usually be the title of a pre-existing step-by-step guide.
|
Use an ordered list and follow step-by-step guide requirements. Include links to step-by-step guides as sub-directions.
|
1. Open your WordPress site
|
Anchor | ||||
---|---|---|---|---|
|
paragraph: use the default Paragraph format in the editor
...
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Layout
Anchor | ||||
---|---|---|---|---|
|
Voice and Tone Tips
Some of these are in the Voice and Tone guide, but we repeat them here. Writing style is especially important, since tutorials are a first point of access into the tool.
...