An easy mistake to make, especially when trying to disambiguate between two same-named notes, is to use a 'partial' path, such as in citing container name/note name. Although not illegal usage, this does not necessarily get parsed as the user assumes. The logic runs like this:
- If the path is an attribute reference, that reference is evaluated. If the path is quoted, the quoted expression is evaluated. Else…
- If the path is a keyword (e.g. parent). Else…
- If the path starts with a '/', it is evaluated relative to the root of the document. If not, it is evaluated relative to the current note. If the absolute or relative path locates a note that exists. Else…
- If the path designates a note that is an immediate child of this note. Else…
- If the path designates any note in the document whose name exactly matches the note.
Bottom line: do not use use partial paths as shorthand. Use a full path or a relative paths as described above.