Renaming Aliases
updated
When a document’s alias changes, Meldoc keeps the old alias working as a redirect. The CLI follows it so your repository keeps syncing.
What the CLI does
meldoc pushwith a file that still uses an old alias updates the existing document instead of creating a new one. The file itself is not rewritten.meldoc pullfinds the file a renamed document already lives in and updates it in place, keeping the file’s currentalias:.
Move a file to the new alias
To bring your repository in line with the new name — the file’s alias: and every [[…]] link pointing at it — run:
meldoc migrate
meldoc validate
meldoc push
Old links keep working in the meantime, so you can do this whenever it suits you. See Renaming & Redirects for renaming in the web.