Skip to content

INTER-2639: docs: render API base URL as code to avoid broken link - #243

Merged
JuroUhlar merged 1 commit into
mainfrom
fix/base-url-code-format
Oct 15, 2026
Merged

JuroUhlar merged 1 commit into
mainfrom
fix/base-url-code-format

Conversation

@JuroUhlar

@JuroUhlar JuroUhlar commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The docs-link-checker reports https://api.fpjs.io/v4 as a broken link (HTTP 404) in the README. The base URL is written as italic text (*{{basePath}}*), and GitHub auto-links it. The URL is an API base path, not a page, so it should be shown as code.

Changes

  • Templates api_doc.mustache, common_README.mustache and common_README_pypi.mustache now render the base URL as inline code. They use {{{basePath}}} so the URL is not HTML-escaped.
  • Generated README.md, README.pypi.md and docs/FingerprintApi.md are updated to match.

No changeset: docs only, no SDK behavior change.

Jira: INTER-2639

🤖 Generated with Claude Code

https://claude.ai/code/session_01D8bTHvDMspvza23W9oMRYJ

The base URL was rendered as italic text, which GitHub auto-links to a 404 page. Use inline code instead.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D8bTHvDMspvza23W9oMRYJ
@JuroUhlar
JuroUhlar requested a balanced review from Copilot October 15, 2026 09:40
@github-actions

Copy link
Copy Markdown
Contributor

☂️ Code Coverage

current status: ✅

Overall Coverage

Statements Covered Coverage Threshold Status
3314 2390 72% 0% 🟢

New Files

No new covered files...

Modified Files

No covered modified files...

updated for commit: b6511b0 by action🐍

@github-actions

Copy link
Copy Markdown
Contributor

⚠️ This PR doesn't contain any changesets. If there are user-facing changes, don't forget to run:

pnpm exec changeset

to create a changeset.

Copilot AI left a comment

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.

🟢 Approval recommended

All six changes consistently apply the intended documentation formatting without affecting SDK behavior.

0 open findings

What changed in this PR

Renders the API base URL as inline code to prevent automatic linking to a non-page endpoint, without changing SDK behavior.

Changes:

  • Updates three documentation templates to use inline code.
  • Synchronizes generated documentation with the templates.
File Description
template/​common_README.mustache Formats the README base URL as code.
template/​common_README_pypi.mustache Formats the PyPI base URL as code.
template/​api_doc.mustache Uses inline code and unescaped URL interpolation.
README.pypi.md Updates generated PyPI documentation.
README.md Updates the generated README.
docs/​FingerprintApi.md Updates generated API documentation.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@JuroUhlar
JuroUhlar merged commit c1dea64 into main Oct 15, 2026
24 checks passed
@JuroUhlar
JuroUhlar deleted the fix/base-url-code-format branch October 15, 2026 10:54
@JuroUhlar JuroUhlar changed the title docs: render API base URL as code to avoid broken link INTER-2639: docs: render API base URL as code to avoid broken link Oct 16, 2026
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.

4 participants