Skip to content

docs: add Scalar API reference page#177

Merged
sachiniyer merged 1 commit intomainfrom
docs/scalar-api-reference
Mar 11, 2026
Merged

docs: add Scalar API reference page#177
sachiniyer merged 1 commit intomainfrom
docs/scalar-api-reference

Conversation

@sachiniyer
Copy link
Copy Markdown
Contributor

@sachiniyer sachiniyer commented Mar 11, 2026

Add a static HTML page that renders the OpenAPI spec using Scalar's
CDN-hosted API reference component. AI agent and client button are
disabled for a clean, focused documentation experience.

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com


Open with Devin

Add a static HTML page that renders the OpenAPI spec using Scalar's
CDN-hosted API reference component. AI agent and client button are
disabled for a clean, focused documentation experience.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor Author

sachiniyer commented Mar 11, 2026

This stack of pull requests is managed by Graphite. Learn more about stacking.

@sachiniyer sachiniyer marked this pull request as ready for review March 11, 2026 01:12
@sachiniyer sachiniyer merged commit f1167fe into main Mar 11, 2026
11 checks passed
@sachiniyer sachiniyer deleted the docs/scalar-api-reference branch March 11, 2026 01:12
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

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

Devin Review found 1 potential issue.

View 2 additional findings in Devin Review.

Open in Devin Review

Comment thread docs/api/index.html
<script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
<script>
Scalar.createApiReference("#app", {
url: "./openapi.json",
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.

🔴 Relative URL ./openapi.json resolves to non-existent docs/api/openapi.json

The url property in the Scalar configuration is set to "./openapi.json", which resolves relative to the HTML file's location (docs/api/). However, openapi.json only exists at the repository root (openapi.json), not at docs/api/openapi.json. This means the API reference page will fail to load the OpenAPI spec, resulting in a broken/empty documentation page.

Suggested change
url: "./openapi.json",
url: "../../openapi.json",
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

sachiniyer added a commit that referenced this pull request Mar 12, 2026
## Summary
- Bumps version from 0.1.10 to 0.1.11
- The release workflow will auto-tag and build artifacts when merged to
main

### Changes since v0.1.10

**Features:**
- Add shell tab completion via clap_complete (#182)
- Add --scan-id flag to bugs list command (#184)
- Add scans list command (#163)
- Add scans to the skill.md for the detail CLI (#185)
- Auto-detect repository in detail-bugs skill (#160)

**Fixes:**
- Show user-friendly error messages instead of debug output (#129)
- Continue list numbering across pages instead of resetting (#130)
- Add file locking to prevent concurrent config overwrites (#131)

**Chores & Refactoring:**
- Replace Makefile with cargo xtask (#159)
- Upgrade all dependencies to latest versions (#158)
- Enable comprehensive clippy lints (pedantic, nursery, restriction)
(#134, #135, #144, #152, #153, #154, #155)
- Add GitHub Pages workflow for API docs (#178)
- Add Scalar API reference page (#177)
- Add integration tests against live API (#181)
- Remove alpha warning from README (#156)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant