How to avoid duplication between notes

With "autocompletion" turned on, if you start to make a link to a related concept, you will be prompted with multiple options. You can pick the best one. That's the best way to avoid duplication and to allow for greater (intentional) consistency in formulations across a vault. In the context of a collaborative undertaking, like a shared vault, it's especially important as the shared "ontologies" and vocabulary is part of what we are aiming to develop in the consortium.

Sometimes, it happens that there are two notes in a vault with exactly the same title, then you can pick one or the other. See this screen shot, especially the third and fourth options:
Illustration of autocompletion with duplicate note titles.png

In this example, if you select one of the two identical titles, that will generate a link which displays which of the two notes it links to, by prepending the folder name.

This is a safe way of disambiguating notes, but it looks ugly. You get, visible in the text, two different links: [[ESDiT Core Concepts/human vulnerability]] and [[Joel's test folder/human vulnerability]]

Perhaps the ugliness is worth maintaining. For example, one might want to have both:

But it's ugly, and it quickly shows up everywhere in your vault. Better to avoid. But the clear this up?

How to eliminate the duplication

This can be fixed with the following workaround. First, make a backup of your vault. (I do this on a Mac by selected the folder the vault is stored in, and making a compressed copy as a ZIP file, which I rename with a date stamp.)

  1. Decide which note will be the primary one.
  2. For the non-primary note, create a new note, with a different title (such as "vulnerability to disruption"), and paste the contents of the non-primary note into it. Now you have, alongside [[Joel's test folder/human vulnerability]] a new note, [[vulnerability to disruption]]. It's very important that you not change the title of the note, because that will cause all occurrances of "human vulnerability" to be replaced with the words of the new title. So: make a new note.
  3. Next, delete the non-primary note.
  4. Finally, open the primary note. Add something like "XYZ" to the title and hit ENTER to propagate the change throughout. In our example, the links entitled [[ESDiT Core Concepts/human vulnerability]] are all changed to [[human vulnerabilityXYZ]], which is then reflected in the [[human vulnerability]] links found in all the notes in the vault.
  5. And then delete the "XYZ" from the title. Now all the links should be standardize, without the reference to the folder. Done!