Details
-
Bug
-
Status: Resolved
-
Major
-
Resolution: Unresolved
-
Cheshire-Cat
-
None
-
DOC-2021-Feb28-S4
-
1
Description
The following deprecated pages are still present in the 7.0 docs and should be removed:
- https://github.com/couchbase/docs-server/blob/release/7.0/modules/backup-restore/pages/backup-restore.adoc
- This page has been replaced by a new page in 7.0: https://github.com/couchbase/docs-server/blob/release/7.0/modules/manage/pages/manage-backup-and-restore/manage-backup-and-restore.adoc
- https://github.com/couchbase/docs-server/blob/release/7.0/modules/backup-restore/pages/incremental-backup.adoc
- This page documents cbbackup, which was removed in 7.0.
Entries for the above two pages were properly removed from the Server nav file, but the files themselves still remain, which means that the content is still being indexed, and xrefs are still resolving to the deprecated pages instead of the new ones.
Page aliases for these two pages were added to https://github.com/couchbase/docs-server/blob/release/7.0/modules/manage/pages/manage-backup-and-restore/manage-backup-and-restore.adoc#L2. However, the line is commented out. This comment should be removed at the same time the two offending files are removed.
Tony Hillman As an FYI, I noticed that the page aliases don't include the .adoc file extension. Although the extension wasn't required when we were first instructed on how to use page aliases, it will soon be required in an upcoming Antora release (likely Antora 4.0). My guess is that Dan will do a scripted change of all of our page aliases at some point, but I've moved over to using .adoc in all of my newly-created page aliases.