Keycloak
15 строк · 1.0 Кб
1[[concept_module]]
2
3= Concept Template and Guidelines
4
5_In the title, include nouns that are used in the body text -- this helps readers and search engines find information quickly._
6
7A concept module describes and explains things such as a product, subsystem, or feature -- what a customer needs to understand to do a task. A concept module may also explain how things relate and interact with other things. The use of graphics and diagrams can speed up understanding of a concept.
8
9* Look at nouns and noun phrases in related task modules and user story assemblies to find the concepts to explain to users.
10
11* A concept module in product documentation should explain only things that are visible to users.
12
13* If a product concept is interesting, but not visible to users, the concept probably does not require explanation in a concept module.
14
15* A concept module should NOT include numbered steps or other wording that instructs a user to execute a command or perform an action. Instead, put that information in a separate task module or user story assembly.
16
17
18