[JBoss JIRA] (TEIID-5975) xref links are broken in docs and other doc issues
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIID-5975?page=com.atlassian.jira.plugi... ]
Steven Hawkins updated TEIID-5975:
----------------------------------
Original Estimate: 5 hours
Remaining Estimate: 5 hours
Sprint: DV Sprint 65, DV Sprint 66 (was: DV Sprint 65)
> 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
> Original Estimate: 5 hours
> Remaining Estimate: 5 hours
>
> 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)
4 years, 5 months
[JBoss JIRA] (TEIIDSB-214) doc links broken by file name changes
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIIDSB-214?focusedWorklogId=12451750&pa... ]
Steven Hawkins logged work on TEIIDSB-214:
------------------------------------------
Author: Steven Hawkins
Created on: 16/Jul/20 11:09 AM
Start Date: 16/Jul/20 11:08 AM
Worklog Time Spent: 2 hours
Work Description: Added html redirects based upon a mapping of old to new names.
Issue Time Tracking
-------------------
Remaining Estimate: 1 hour (was: 3 hours)
Time Spent: 2 hours
Worklog Id: (was: 12451750)
> doc links broken by file name changes
> -------------------------------------
>
> Key: TEIIDSB-214
> URL: https://issues.redhat.com/browse/TEIIDSB-214
> Project: Teiid Spring Boot
> Issue Type: Bug
> Components: examples
> Reporter: Steven Hawkins
> Assignee: Steven Hawkins
> Priority: Major
> Fix For: 1.6.0
>
> Original Estimate: 3 hours
> Time Spent: 2 hours
> Remaining Estimate: 1 hour
>
> There are quite a few places that reference the older Teiid doc file names (the new names are like r_...-...). Those links should either be converted to reference 13.0.x, which still uses those names, or updated to 14.0.x with new paths.
--
This message was sent by Atlassian Jira
(v7.13.8#713008)
4 years, 5 months
[JBoss JIRA] (TEIID-5975) xref links are broken in docs and other doc issues
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIID-5975?page=com.atlassian.jira.plugi... ]
Steven Hawkins commented on TEIID-5975:
---------------------------------------
I've updated the broken links to the new adoc file names, so this just leaves resolving the xref issue.
> 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
>
> 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)
4 years, 5 months
[JBoss JIRA] (TEIID-5975) xref links are broken in docs and other doc issues
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIID-5975?page=com.atlassian.jira.plugi... ]
Work on TEIID-5975 started by Steven Hawkins.
---------------------------------------------
> 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
>
> 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)
4 years, 5 months
[JBoss JIRA] (TEIID-5993) Add robots.txt to better crawl content
by Steven Hawkins (Jira)
Steven Hawkins created TEIID-5993:
-------------------------------------
Summary: Add robots.txt to better crawl content
Key: TEIID-5993
URL: https://issues.redhat.com/browse/TEIID-5993
Project: Teiid
Issue Type: Quality Risk
Components: Documentation
Reporter: Steven Hawkins
Assignee: Steven Hawkins
We should do a better job of directing what pages are crawled. I added a robots.txt to prevent the crawling of legacy. Something similar should be added for teiid.github.com to allow only the crawling of master.
--
This message was sent by Atlassian Jira
(v7.13.8#713008)
4 years, 5 months
[JBoss JIRA] (TEIIDSB-214) doc links broken by file name changes
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIIDSB-214?page=com.atlassian.jira.plug... ]
Steven Hawkins updated TEIIDSB-214:
-----------------------------------
Original Estimate: 3 hours
Remaining Estimate: 3 hours
Sprint: DV Sprint 65, DV Sprint 66 (was: DV Sprint 65)
> doc links broken by file name changes
> -------------------------------------
>
> Key: TEIIDSB-214
> URL: https://issues.redhat.com/browse/TEIIDSB-214
> Project: Teiid Spring Boot
> Issue Type: Bug
> Components: examples
> Reporter: Steven Hawkins
> Assignee: Steven Hawkins
> Priority: Major
> Fix For: 1.6.0
>
> Original Estimate: 3 hours
> Remaining Estimate: 3 hours
>
> There are quite a few places that reference the older Teiid doc file names (the new names are like r_...-...). Those links should either be converted to reference 13.0.x, which still uses those names, or updated to 14.0.x with new paths.
--
This message was sent by Atlassian Jira
(v7.13.8#713008)
4 years, 5 months
[JBoss JIRA] (TEIIDSB-214) doc links broken by file name changes
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIIDSB-214?page=com.atlassian.jira.plug... ]
Steven Hawkins resolved TEIIDSB-214.
------------------------------------
Resolution: Done
Added redirects as a catch all for incoming links. We can correct linking docs as needed.
> doc links broken by file name changes
> -------------------------------------
>
> Key: TEIIDSB-214
> URL: https://issues.redhat.com/browse/TEIIDSB-214
> Project: Teiid Spring Boot
> Issue Type: Bug
> Components: examples
> Reporter: Steven Hawkins
> Assignee: Steven Hawkins
> Priority: Major
> Fix For: 1.6.0
>
>
> There are quite a few places that reference the older Teiid doc file names (the new names are like r_...-...). Those links should either be converted to reference 13.0.x, which still uses those names, or updated to 14.0.x with new paths.
--
This message was sent by Atlassian Jira
(v7.13.8#713008)
4 years, 5 months
[JBoss JIRA] (TEIID-5992) Pages missing from summary
by Steven Hawkins (Jira)
[ https://issues.redhat.com/browse/TEIID-5992?focusedWorklogId=12451748&pag... ]
Steven Hawkins logged work on TEIID-5992:
-----------------------------------------
Author: Steven Hawkins
Created on: 15/Jul/20 4:23 PM
Start Date: 15/Jul/20 4:23 PM
Worklog Time Spent: 15 minutes
Issue Time Tracking
-------------------
Remaining Estimate: 0 minutes
Time Spent: 15 minutes
Worklog Id: (was: 12451748)
> Pages missing from summary
> --------------------------
>
> Key: TEIID-5992
> URL: https://issues.redhat.com/browse/TEIID-5992
> Project: Teiid
> Issue Type: Bug
> Components: Documentation
> Reporter: Steven Hawkins
> Assignee: Steven Hawkins
> Priority: Major
> Fix For: 15.0
>
> Time Spent: 15 minutes
> Remaining Estimate: 0 minutes
>
> Several docs are missing:
> r_key-preserved-tables (in the summary as singular)
> r_operator-precedence
--
This message was sent by Atlassian Jira
(v7.13.8#713008)
4 years, 5 months