-
Notifications
You must be signed in to change notification settings - Fork 30
Fixing broken links in MTA docs #401
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
|
@apinnick: please review. |
|
@apinnick -- something is odd with the link in line 148 of cli-args.adoc. I changed the link when resolving https://issues.redhat.com/browse/WINDUP-3033, a Jira that come in yesterday as I was working on this PR. I saw that in terms of the document referenced, Jira 3033 relates to the same broken document link as the Getting Started /Introduction to the Migration_Toolkit_for_Applications issue in this PR -- the broken link led to a 404 message, which i fixed. I noticed that once I resolved the 404 issue, the link did not point to the exact section desired of the document: https://access.redhat.com/documentation/en-us/migration_toolkit_for_applications/5.1/html-single/introduction_to_the_migration_toolkit_for_applications/supported_configurations#migration_paths_getting-started-guide. Instead, the link only led to the document, not the correct section, meaning it needed additional work. So I changed the link in line 148 of cli-args.adoc accordingly. When I previewed the rendered document using master.adoc, the link (in the warning message) worked perfectly, but in the bccutil and preview versions of the CLI guide (see the link in the warning message in http://file.emea.redhat.com/rhoch/01032021/clig/html-single/#target_argument_cli-guide), the document opens but not the correct section. (https://access.redhat.com/documentation/en-us/migration_toolkit_for_applications/5.1/html-single/introduction_to_the_migration_toolkit_for_applications/index#migration_paths). [Ctrl+Shift+A in any master.adoc lets you see a fully rendered version of the whole document, unlike when use the command with other .adoc files]. I have spent at least 2 hours on making small changes to the link in cli-args.adoc, but I still cannot get it to point correctly to the right section (https://access.redhat.com/documentation/en-us/migration_toolkit_for_applications/5.1/html-single/introduction_to_the_migration_toolkit_for_applications/index#migration_paths_getting-started-guide). Could you please take a look when you have time? |
Resolved |
|
@apinnick: please review. I ran the link checker again to be sure all links are OK. |
|
@apinnick: please review. |
|
@apinnick : changes made. Please review. |
Fixes the broken links in MTA docs issue raised in https://issues.redhat.com/browse/WINDUP-3014.
Previews:
For the repaired link to Introduction to the Migration Tools for Applications guide, formerly the Getting Started Guide:
http://file.emea.redhat.com/rhoch/01032021/clig/html-single/#about_mta_cli-guide
http://file.emea.redhat.com/rhoch/01032021/maveng/html-single/#about_mta_maven-guide
http://file.emea.redhat.com/rhoch/01032021/pluging/html-single/#about_mta_plugin-guide
http://file.emea.redhat.com/rhoch/01032021/rulesg/html-single/#about_rules_dev_guide_rules-development-guide
http://file.emea.redhat.com/rhoch/01032021/webcg/html-single/#about_mta_web-console-guide
For the repaired link to the IDE plugin download:
http://file.emea.redhat.com/rhoch/01032021/pluging/html-single/#installing-web-console_plugin-guide-offline
Installation procedures for the web console, CLI, and IDE plugin:
http://file.emea.redhat.com/rhoch/01032021/webcg/html-single/#installing_the_web_console
http://file.emea.redhat.com/rhoch/01032021/pluging/html-single/#installing-web-console_plugin-guide
http://file.emea.redhat.com/rhoch/01032021/clig/html-single/#installing-web-console_cli-guide
Intoduction to the Migration Toolkit for Applications http://file.emea.redhat.com/rhoch/01032021/gsg/html-single/