Hey everyone, I wanted to post regarding an update we just pushed out, having to do with links to the old manual.
I've been working with some awesome folks from our Support Apps team to develop a redirection solution. As of now, we have some mappings and redirects in places, so any old bookmarks you come across but haven't updated yourself should redirect you to an appropriate page, or the search results page on the new site. For example, below is a link to the old manual's Gateway Command-Line Utility page. If you click it, it should momentarily redirect you to the new manual's page.
https://docs.inductiveautomation.com/display/DOC81/Gateway+Command-line+Utility+-+gwcmd
The same is true for 7.9 links:
https://docs.inductiveautomation.com/display/DOC79/tag
In the case of 8.0 links, since that version isn't LTS and wasn't carried over (excluding the PDF on the legacy manual page), we'll treat as an 8.1 page so folks are at least a bit closer to some helpful docs. For example:
https://docs.inductiveautomation.com/display/DOC80/Modbus+Addressing
In the case that you have a link pointing at the old site that doesn't perfectly match with an existing page (for example, a link to an 8.0 page that was renamed in the 8.1 manual), we'll instead redirect you to the search page with the page name loaded into the search, as opposed to just leaving you at a 404 page. For example:
https://docs.inductiveautomation.com/display/DOC81/Not+A+Real+Page
Also, the system doesn't account for anchors, but it does parse out the name of the page and try to redirect, so it should at least get you to the page.
That should take care of about ~90% of use cases. The remaining include a few niche, but important, cases. For example,
- Links to the old programmer's guide won't work yet (they'll need to redirect to the new guide).
- There's also small collection of links to the old manual that deviated from the
/display/DOC##/Page
pattern and used a pageID instead (pages/viewpage.action?pageId=#####
), specifically in cases where special characters were in the name of the page.
In both cases, we'll work on incorporating them into the new system.
Regarding links on forum posts, most of them should redirect to an appropriate page or search results matching the old page name as of now. As I mentioned above, there are a few special cases we'll need to work on. Once we have the rest of those in, all ~2808 distinct links here on the forums pointing to the docs should be at least somewhat helpful again.
Thanks again for the feedback gang. We'll keep working on the new manual to improve the overall experience.