docs: quick-wins typos, _order.yaml fixes, empty link removal#52
Merged
Merged
Conversation
Audit-driven cleanup (May 16 audit, fix-now items, Scope A). Mechanical fixes only; no link rewrites or scope expansion. Typos (17 line edits across 13 files): - DEVELOPER/dev-tools/resource-monitor/rrm-data-collection-mode.md L2 "Resouce" -> "Resource" (nav title) L43 "Requried" -> "Required" (HTML table cell) - DEVELOPER/discovery/continue-watching-cloud.md L14 "Canda" -> "Canada" - DEVELOPER/certification-overview/cert-tests/static-analysis-tool-1.md L15 "in order to published" -> "in order to publish" - DEVELOPER/certification-overview/cert-tests/channel-behavior-analysis-tool.md L15 "in order to published" -> "in order to publish" - DEVELOPER/getting-started/first-steps.md L29 "being running" -> "begin running" - DEVELOPER/core-concepts/index.md L28 "Roku app app development" -> "Roku app development" - DEVELOPER/roku-pay/quickstart/product-catalog.md L499 "betan app" -> "beta app" (found during sweep, not in audit) - REFERENCES/brightscript/interfaces/ifaudioresource.md L19 "roAudioResouce" -> "roAudioResource" (prose; found during sweep) - REFERENCES/brightscript/components/roaudioresource.md L15 "roAudioResouce" -> "roAudioResource" (prose; found during sweep) - VIDEOS/demos/index.md L27 "explained reviewed" -> "reviewed" L29 "Resoure Monitor" -> "Resource Monitor" L31 "Resoure Monitor" -> "Resource Monitor" L51 "betan app feature" -> "beta app feature" - VIDEOS/demos/summit-2021.md L15 "betan app feature" -> "beta app feature" (duplicate boilerplate; found during sweep) - THE ROKU CHANNEL/video-on-demand/index.md L66 "Not that partners" -> "Note that partners" - THE ROKU CHANNEL/live-linear/ovp-linear-ingest-spec.md L713 "Roku Direct Published feed specification" -> "Roku Direct Publisher feed specification" _order.yaml nav fixes: - DEVELOPER/roku-pay/_order.yaml signup_best-practices -> signup-best-practices (file is signup-best-practices.md) signin_best-practices -> signin-best-practices (file is signin-best-practices.md) - THE ROKU CHANNEL/video-on-demand/_order.yaml remove 'recs' (no backing file in directory) Empty-link cleanup: - DEVELOPER/dev-tools/sgdex.md L17 delete empty-target link (duplicates working link on L15) Out of scope (deferred to follow-up PR, requires URL convention decision): - ovp-linear-ingest-spec.md L15/L396/L707 broken /trc-docs/ links - ovp-linear-ingest-spec.md L713 broken json-dp-spec.md links (target does not exist anywhere in repo) Lint baseline preserved: docs-lint shows same 3 findings as before this PR (all in REFERENCES/brightscript/interfaces/ifscreen.md, unchanged).
This was referenced May 20, 2026
This was referenced May 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Audit-driven cleanup (May 16 audit, fix-now items, Scope A). Mechanical fixes only; no link rewrites or scope expansion.
_order.yamlnav fixes: 3 entries (2 underscore-vs-hyphen mismatches inDEVELOPER/roku-pay/, 1 orphanrecsentry inTHE ROKU CHANNEL/video-on-demand/)DEVELOPER/dev-tools/sgdex.mdL17 -- duplicate of working link on L15)Lint baseline preserved:
docs-lintshows the same 3 findings as before this PR (all inREFERENCES/brightscript/interfaces/ifscreen.md, unchanged).File-by-file
Typos
DEVELOPER/dev-tools/resource-monitor/rrm-data-collection-mode.mdDEVELOPER/discovery/continue-watching-cloud.mdDEVELOPER/certification-overview/cert-tests/static-analysis-tool-1.mdDEVELOPER/certification-overview/cert-tests/channel-behavior-analysis-tool.mdDEVELOPER/getting-started/first-steps.mdDEVELOPER/core-concepts/index.mdDEVELOPER/roku-pay/quickstart/product-catalog.mdREFERENCES/brightscript/interfaces/ifaudioresource.mdREFERENCES/brightscript/components/roaudioresource.mdVIDEOS/demos/index.mdVIDEOS/demos/summit-2021.mdTHE ROKU CHANNEL/video-on-demand/index.mdTHE ROKU CHANNEL/live-linear/ovp-linear-ingest-spec.md_order.yamlDEVELOPER/roku-pay/_order.yamlsignup_best-practices->signup-best-practices(target file issignup-best-practices.md)signin_best-practices->signin-best-practices(target file issignin-best-practices.md)THE ROKU CHANNEL/video-on-demand/_order.yamlrecs(no backing file in directory)Empty link
DEVELOPER/dev-tools/sgdex.mdL17Out of scope (deferred to follow-up PR -- requires URL convention decision)
ovp-linear-ingest-spec.mdL15 / L396 / L707: broken/trc-docs/...links pointing at legacy paths. L396 + L707 use fulldeveloper.roku.comURLs with locale prefixes (and L707 hasen-ot-- not a valid locale).ovp-linear-ingest-spec.mdL713: 3 broken/docs/specs/direct-publisher-feed-specs/json-dp-spec.mdlinks. Target file does not exist anywhere in the repo. Needs a content decision (replace with external URL, delete the link, or restore the missing spec doc).Test plan
node .github/scripts/docs-lint/index.mjsshows same 3 baseline findings (all inifscreen.md, untouched)_order.yamlentries now match actual filenames (verified byls docs/DEVELOPER/roku-pay/)Related
Part of the May 16 audit cleanup plan (
dev-doc-review-report-2026-05-16.md§ 16 step 1). Next sweep PRs in the queue: BrightScript fence labeling (~1,300 fences), terminology canonicalization (~25 hits), broken-absolute-link sweep (252 remaining).