search

srid / neuron

Future-proof note-taking and publishing based on Zettelkasten (superseded by Emanote: https://github.com/srid/emanote)
https://neuron.zettel.page
GNU Affero General Public License v3.0
1.52k stars 150 forks source link

Clarify that directories/note IDs must be globally unique when using the dirtree plugin #512

Closed flyinggrizzly closed 3 years ago

flyinggrizzly commented 3 years ago

This is the only thing I stumbed on--otherwise the documentation for the dirtree plugin was clear for me.

srid commented 3 years ago

Thanks. Will merge.

We should further explain the rationale and utility behind this uniqueness criteria. In work/notes/, "notes" is a bad name for an atomic zettel (usually it would be someething like work/Project1/ or work/Potential clients/).

A good example would be 2020/12/2020-12-02 - which would conflict with other years' December, and can be solved by renaming the folder to 2020/2020-12/2020-12-02. The benefit is ... simplicity in linking, without complicated linking strategies in neuron, spamming user's mental model. Just link to year, month or day using their file/directory name. It allows you to have a 2020-20.md zettel, which gets "merged" automatically with the 2020-20/ directory zettel, and you can link to it as [[2020-20]] without banging the head against the wall thinking in terms of filesystem paths.

flyinggrizzly commented 3 years ago

I'll see if I can't get something concise and useful drafted about ID atomicity.