Oxygen XML Forum

Hello,

I've noticed that for a project which contains a Git submodule and a Master File that links will not update if a file in the submodule is moved or renamed after a pull update. I'm guessing this is the expected behavior since the files were updated automatically outside of the Project View in Oxygen.

Am I correct that this is the expected behavior or is there something that I could do differently so that links automatically update? Is it generally recommended that files in a submodule should not be removed or renamed to avoid broken links? Maybe this is a good case where keys should be used instead of direct links?

Thanks,
Jonathan

Hello Jonathan,

Yes, this is indeed the expected behavior because, as you suspected, references are updated only if the rename/move operations are performed inside Oxygen, in the Project side-view.

Is it generally recommended that files in a submodule should not be removed or renamed to avoid broken links?

Well, we don't have much experience with Git submodules, therefore I cannot give you any recommendations. But if you want to make sure you don't have broken references, you can use the DITA map completeness check from time to time (https://www.oxygenxml.com/doc/versions/ ... idate.html).

Maybe this is a good case where keys should be used instead of direct links?

Yes, I would say using keys should make life easier. For example, if you rename a file, you would only need to update the key instead of updating all the direct references.

All the best wishes,
Sorin Carbunaru
Oxygen XML Editor