Filenames for notes

I’m just getting started today, and one of the first things I did was change the capture template to remove the date from newly create note filenames. It makes sense for me to use short descriptive names, and to capture the date created and last modified times in the file headers.

I wonder though, since the default is to use the dates in the filenames, if there is a reason for this? If there any functionality in org-roam that requires filenames include the creation date? I wanted to confirm this before I get too far along!

Thanks,

Tyler

It’s more like a workflow convention used in the contemporary software striving to implement the Zettelkasten method. I’m not aware of any issues with Org Roam that may arise when not using dates in filenames.

Using timestamps may be handy though, because minute-precise timestamps in practice ensure the filenames are unique, which is an Org Roam requirement. When you have 1000 notes, I’d say the odds are high your short descriptive filename gets incidentally duplicated when adding note number 1001. So, unless you ensure uniqueness in some other way, using timestamps helps you not to rely on your memory when creating new notes. Looking for notes may also be easier, since people tend to remember, approximately, when they did particular things. As a bonus you get a neatly sorted list of files in your file manager.

There’s no hard requirement on filenames for Org-roam. You can think of it in terms of pros and cons:

Title

Pros:

  1. Human-readable
  2. Accessible via normal file-managers

Cons:

  1. Need to think of descriptive file-name beforehand: some find it difficult to name their notes before a title comes to mind
  2. Might not be unique, which can cause issues downstream (e.g. Foo and foo both result in the same file-name). This is unlikely to happen

(1) is somewhat alleviated by the new automatic file renaming mechanism based on title.

ID

Pros:

  1. Guaranteed to be unique
  2. File independent of note content: links don’t have to change when file is renamed

(2) is less of a pro, because we have some mechanisms in place to update the links on file changes, but this is still brittle to bulk renames (see https://github.com/org-roam/org-roam/issues/1041)

Cons:

  1. Can’t navigate around files without Org-roam, since IDs are incomprehensible
1 Like