openstack/openstack-manuals
Code Issues Proposed changes

Merge "[contributor] Editorial changes"

Browse Source
This commit is contained in:
Jenkins 2016-06-09 09:43:12 +00:00 committed by Gerrit Code Review
commit d094e4a484
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/contributor-guide/source/topic-structure.rst
View File

@ -19,7 +19,7 @@ any topic. Therefore, each topic represents an independent piece of
information. Each topic states prerequisites and dependencies, if any, as
well as providing information about the next steps.
In topic-based authoring a chunk of information is called `topic`.
In topic-based authoring, a chunk of information is called a `topic`.
Structure the information around the following topics:
@ -41,10 +41,10 @@ Structure the information around the following topics:
**Task**
A task topic provides a sequence of steps detailing how to achieve a
certain task. A section (or chapter) is the high level task topic.
certain task. A section (or chapter) is the high-level task topic.
Typically, a section includes multiple sub-sections: task, concept, and
reference topics. Start the title of a high level task topic with a verb
reference topics. Start the title of a high-level task topic with a verb
in gerund and the title of a subtask topic with a verb in imperative.
Task topics are the most important topics in any technical documentation.