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