Topic-based writing

Structures all content around topics that can be mixed and reused in different contexts.

Does not follow a linear structure as in books.

Is perfectly suited for online documentation. User can jump to a topic from every point in the documentation.

Unique piece of content with a specific purpose (task, concept or reference).

Self-contained.

Deals with one subject.

Does not require external content to understand.

Is as short as possible and as required.

Is suited for the target group and implies that the reader has the required knowledge to understand the subject.

Answers the questions of the reader.

Links to related topics.

Task, see general information in Create a task topic and an example in Copy an app from an existing app.

Concept, see general information in About concept topics and an example in User.

Reference, see general information in Reference topic and an example in reference-topic-example.adoc.