Skip to content

Docs: Fix broken links - #717

Merged
huang195 merged 1 commit into
rossoctl:mainfrom
esnible:fix-links
Jul 29, 2026
Merged

Docs: Fix broken links#717
huang195 merged 1 commit into
rossoctl:mainfrom
esnible:fix-links

Conversation

@esnible

@esnible esnible commented Jul 29, 2026

Copy link
Copy Markdown
Member

Summary

Fix the broken links reported by lychee --no-progress './**/*.md' --exclude-path aiac --exclude-path authbridge/demos/github-issue --exclude-path go/pkg/mod/github.com --exclude-path go/pkg/mod/golang.org --exclude-path docs/proposals

Fixes #

Resolves #714
Resolves #713
Resolves #712
Resolves #711
Resolves #697
Resolves #696
Resolves #695
Resolves #694

Summary by CodeRabbit

  • Documentation
    • Updated installation and setup links to current Rossoctl getting-started and quickstart guides.
    • Corrected links for AuthBridge binaries, prerequisites, plugins, and demo walkthroughs.
    • Updated security reporting instructions to link directly to the advisory submission page.
    • Refined deployment and related documentation for improved accuracy and clarity.

Signed-off-by: Ed Snible <snible@us.ibm.com>
@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Documentation-only updates refresh Rossoctl installation links, correct AuthBridge cross-references, remove an outdated binary reference, and point security reporting guidance to GitHub’s advisory form.

Changes

Documentation updates

Layer / File(s) Summary
Rossoctl installation references
CLAUDE.md, authbridge/README.md, authbridge/demos/README.md, authbridge/demos/weather-agent/*
Rossoctl setup links now use current installer, quickstart, or getting-started documentation paths.
AuthBridge documentation references
authbridge/README.md, authbridge/cmd/README.md, authbridge/demos/*, authbridge/docs/plugin-tutorial.md
AuthBridge binary and plugin references are corrected, and the outdated unified binary entry is removed.
Security advisory reporting link
SECURITY.md
Security reporting instructions now link directly to GitHub’s new advisory form.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

  • rossoctl/cortex#705: Updates AuthBridge demo Rossoctl installation links to the docs/getting-started/install.md path.

Suggested reviewers: huang195, ibrahim2595

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: multiple documentation links were fixed across markdown files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@authbridge/README.md`:
- Line 9: Update the README statement near “Two container images are published”
to accurately describe the table: state that there are two base images plus the
authbridge-lite build variant, or revise the count to reflect all three listed
image identifiers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 28424d67-b71c-4aac-814c-b6920b274780

📥 Commits

Reviewing files that changed from the base of the PR and between afc2321 and 4b6f62f.

📒 Files selected for processing (9)
  • CLAUDE.md
  • SECURITY.md
  • authbridge/README.md
  • authbridge/cmd/README.md
  • authbridge/demos/README.md
  • authbridge/demos/github-issue/demo-manual.md
  • authbridge/demos/weather-agent/demo-ui.md
  • authbridge/demos/weather-agent/demo-with-abctl.md
  • authbridge/docs/plugin-tutorial.md

Comment thread authbridge/README.md
## Deployment Modes

The [`cmd/authbridge/`](./cmd/authbridge/) directory contains a unified binary that supports three deployment modes in a single codebase. Two container images are published:
Two container images are published:

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Clarify the published-image count.

This says two container images are published, but the table lists three image identifiers, including authbridge-lite. Please state that there are two base images plus the authbridge-lite build variant, or update the count.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@authbridge/README.md` at line 9, Update the README statement near “Two
container images are published” to accurately describe the table: state that
there are two base images plus the authbridge-lite build variant, or revise the
count to reflect all three listed image identifiers.

@huang195
huang195 merged commit 9a97ad4 into rossoctl:main Jul 29, 2026
21 checks passed
@github-project-automation github-project-automation Bot moved this from New/ToDo to Done in Rossoctl Issue Prioritization Jul 29, 2026

- **UI Deployment**: See [demo-ui.md](demo-ui.md) for deploying via the Rossoctl dashboard
- **AuthBridge Binary**: See the [AuthBridge README](../../cmd/authbridge/README.md) for inbound
- **AuthBridge Binary**: See the [AuthBridge README](../../cmd/authbridge-envoy/README.md) for inbound

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment