HI Dojo,
I've found some dead links saved in internal offline documentation we had,
e.g.:
but I'm unsure if the above article got moved to a renamed path or removed as perhaps no longer relevant.
Are there any guidelines to quickly remap older links?
I mean, is there any shared reference to know if something went on git-hub under a specific new path?
Thanks
If the page name or the uid (this is unique identifier that is given to each document in DocFx) is still the same after the update, you can do the following:
The build of the docs generates an xref map. This is an overview of all the articles. You can download it via http://docs.dataminer.services/xrefmap.yml. Once downloaded, open the file and look for an entry with the page name (e.g./Alarm_filters.html) or uid (e.g. uid: Alarm_filters). In the current version, you'll find an entry that points to dataminer/Operator_guide/Alarms/About_alarms/Alarm_filters.html which is the updated location.
Found the article I needed from the mapping in the .yml,
so I'm marking this as solved – many thanks
Hi Alberto. Last week, we merged the "User Guide" section into the "DataMiner Overview" section. As to folders, everything is now under the "/dataminer/" folder. Basically, the "basic functionality" folder has now become the "operator guide", and the "advanced functionality" has now become the "administrator guide". However, note that a lot of other, additional restructuring has been done as well.
The alarm filter page you gave as an example can now be found here: https://docs.dataminer.services/dataminer/Operator_guide/Alarms/About_alarms/Alarm_filters.html
Hi José – long time no see – hope you're fine
Thanks for the info – I'll refer to the new sections.
Question: where some content has simply moved to a new section, would it be viable to add a link to the new URL in the older page?
This might help during the transitions
Do you mean keeping "dummy files" at the old locations and adding HTTP redirects to them? Sorry, that is not feasible given the scale of the changes.
Understood – thanks for the update
Thanks, Pedro – this yml will help in this phase