Topics

Summary

This describes the Topic Branch in more detail

Sections

Use Cases

Use cases are about jobs to be done. What goal can our users accomplish through the use of various features in this particular topic?

Properties:

  • should not exceed 3 use cases
  • usually in bullet point format
  • should highlight specifics

Example

No note with name dendron.topic.templates found in cache during parsing.

Features

Features are individual units of functionality of a particular topic. Shoud not enumerate every single feature but group related functionality into a single feature set.

Properties:

  • should not exceed 5 features
  • usually presented in section/paragraph format
  • feature should be written from a job to be done perspective and solve a customer pain point

Example

No note with name dendron.topic.templates found in cache during parsing.

  • good
    • this goes into the job to be done (changing the organization of your notes) and the benefit provided
### Re-organize your notes without breaking your links

When you need to change the structure of your notes, whether this is the hierarchy, a single note, or a section header within a note - refactoring commands help you make the changes while keeping all your links consistent.
  • bad
    • while this explains what refactoring does, it doesn't explain why you might want to do it
### Refactor a hierarchy

Dendron can update your note hierarchies and links pointing to the note

Lookup