Change 33379
Convert internal doc-to-doc AsciiDoc cross-references from absolute
Workshop URLs to relative links.
Full sweep following up the SDP_CodingStandard_bash.adoc pilot: converts
the remaining 9 absolute workshop.perforce.com/view/p4-sdp/<stream>/doc/...
internal links (some pinned to a stale r25.1, some to /main/) across
SDP_Win2Linux_Guide.adoc, SDP_MigrationAndUpgradeGuide.adoc, and
SDP_Legacy_Upgrades.Unix.adoc into relative links (bare filenames, since
all docs live in the same doc/ directory). Verified locally with
asciidoctor -w (no errors) and confirmed all target files/anchors exist,
which caught one genuine pre-existing broken anchor
(SDP_Guide.Windows.html#_instance, now #_instance_names) that had been
hiding behind an unclickable absolute URL.
Also regenerated the checked-in HTML for all 3 changed docs plus
SDP_Guide.Windows.html (found stale -- its HTML predated its own .adoc
source by ~5 months, which is exactly how the broken anchor above went
unnoticed) via doc/Makefile, for review. The resulting diffs are
legitimate accumulated .adoc source changes (e.g. Helix->P4 rebrand text,
updated contact email) that had never been regenerated into HTML, not new
content changes from this commit.
Not touched: a curl download URL in SDP_Legacy_Upgrades.Unix.adoc pinned
to r25.1 -- pinning an exact download URL to a specific release being
upgraded to/from is correct behavior there, unlike doc cross-references.
Workshop URLs to relative links.
Full sweep following up the SDP_CodingStandard_bash.adoc pilot: converts
the remaining 9 absolute workshop.perforce.com/view/p4-sdp/<stream>/doc/...
internal links (some pinned to a stale r25.1, some to /main/) across
SDP_Win2Linux_Guide.adoc, SDP_MigrationAndUpgradeGuide.adoc, and
SDP_Legacy_Upgrades.Unix.adoc into relative links (bare filenames, since
all docs live in the same doc/ directory). Verified locally with
asciidoctor -w (no errors) and confirmed all target files/anchors exist,
which caught one genuine pre-existing broken anchor
(SDP_Guide.Windows.html#_instance, now #_instance_names) that had been
hiding behind an unclickable absolute URL.
Also regenerated the checked-in HTML for all 3 changed docs plus
SDP_Guide.Windows.html (found stale -- its HTML predated its own .adoc
source by ~5 months, which is exactly how the broken anchor above went
unnoticed) via doc/Makefile, for review. The resulting diffs are
legitimate accumulated .adoc source changes (e.g. Helix->P4 rebrand text,
updated contact email) that had never been regenerated into HTML, not new
content changes from this commit.
Not touched: a curl download URL in SDP_Legacy_Upgrades.Unix.adoc pinned
to r25.1 -- pinning an exact download URL to a specific release being
upgraded to/from is correct behavior there, unlike doc cross-references.
Tip: Use n and p to cycle through the changes.