Skip to content

Documentation outdated: docs/monitoring.md - broken links to non-existent files #951

@github-actions

Description

@github-actions

Problem

docs/monitoring.md lines 541–542 contain broken internal links pointing to files that do not exist:

- [azlin distributed top](./distributed_top.md) - Live process monitoring
- [azlin cost tracking](./cost_tracking.md) - Cost estimation and tracking

Both distributed_top.md and cost_tracking.md are missing from the docs/ directory.

Impact

Users following these "See Also" links will get 404 errors on the documentation site. This undermines confidence in the docs and leaves gaps in navigation.

Suggested Fix

Option A – Update the links to point to existing related files:

  • distributed_top.md → could link to monitoring content in docs/monitoring-commands-vm-discovery.md or the docs/features/ directory
  • cost_tracking.md → could link to docs/cost-optimization-intelligence.md

Option B – Create the missing stub documents with appropriate content redirecting to the correct pages.

Option C – Remove the broken "See Also" links and replace with accurate references to existing docs.

Steps to Reproduce

  1. Open the deployed docs at (rysweet.github.io/redacted)
  2. Navigate to the Monitoring section
  3. Click "azlin distributed top" or "azlin cost tracking" links
  4. Observe 404 error

Generated by Documentation Freshness Checker

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocumentationImprovements or additions to documentationgood-first-issue

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions