[teiid-issues] [JBoss JIRA] (TEIID-5975) xref links are broken in docs and other doc issues

[Steven Hawkins (Jira)]

     [ https://issues.redhat.com/browse/TEIID-5975?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Steven Hawkins resolved TEIID-5975.
-----------------------------------
    Fix Version/s: 15.0
       Resolution: Done


There ended up being quite a bit to correct.  Along with the intermediate commits the final approach was to use templating for prod using xref and otherwise using links.

> xref links are broken in docs and other doc issues
> --------------------------------------------------
>
>                 Key: TEIID-5975
>                 URL: https://issues.redhat.com/browse/TEIID-5975
>             Project: Teiid
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Steven Hawkins
>            Assignee: Steven Hawkins
>            Priority: Major
>             Fix For: 15.0
>
>   Original Estimate: 5 hours
>          Time Spent: 7 hours
>  Remaining Estimate: 0 minutes
>
> Productization changes to use xref for links do not render correctly with the usual gitbook build.  They produce an invalid anchor link in the current doc.
> There are also some pages that look like they weren't updated to the new page names.  Running a regex like 
> {noformat}
> :[^/A-Z:]*[A-Z][^/:]*.adoc
> {noformat}
>  over the reference guide shows at least 86 now invalid links. [~broldan] do you have a master list of old to new doc file names that could script getting those updated?



--
This message was sent by Atlassian Jira
(v7.13.8#713008)