[DOCS-507] Need to keep track of links published/changed so we can properly do redirects Created: 10/Sep/12  Updated: 30/Oct/23  Resolved: 15/Jan/13

Status: Closed
Project: Documentation
Component/s: manual, production
Affects Version/s: None
Fix Version/s: Server_Docs_20231030

Type: Improvement Priority: Minor - P4
Reporter: Ed Costello Assignee: Ed Costello
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 11 years, 5 weeks, 1 day ago

 Description   

The benefit of using Sphinx to maintain intradocument links is that they're automatically updated when the URL changes, however we need to find a way to track all URLs we publish so that we can properly do redirects if a document is moved/renamed/etc.



 Comments   
Comment by Sam Kleinman (Inactive) [ 15/Jan/13 ]

Not automated, but the build improvements (i.e. easy to add new symlinks) help this, as well as work ongoing with ian.bentley@10gen.com around redirects.

Comment by Sam Kleinman (Inactive) [ 11/Sep/12 ]

Having said that what's the desired form for these? Do we want to commit a list of URLs and have a script that produces an error when we delete (possibly as a product of moving) a page that used to be on the list, unless we add that page to a list of files that get redirected, somehow? Redirection can either be symlinks or lines in an .htaccess file...

Seems possible but involved. Has the benefit of being "branch safe," which is big...

Comment by Sam Kleinman (Inactive) [ 10/Sep/12 ]

I did one of these today, and just added stuff to create a symlink in the makefile, which isn't what we want but causes things to not break. I think we'd need full control over our web server to make this work totally correctly. See the following points in the makefile:

https://github.com/mongodb/docs/blob/master/makefile#L122

https://github.com/mongodb/docs/blob/master/makefile#L213

Generated at Thu Feb 08 07:38:50 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.