Skip to content

Readme: replace OpenAPI badge#3077

Merged
RobinTail merged 4 commits intomasterfrom
RobinTail-patch-3
Nov 21, 2025
Merged

Readme: replace OpenAPI badge#3077
RobinTail merged 4 commits intomasterfrom
RobinTail-patch-3

Conversation

@RobinTail
Copy link
Copy Markdown
Owner

@RobinTail RobinTail commented Nov 21, 2025

There seems to be an issue at shields.io.
For several days the badge is gray and not operational, no one cares.

Summary by CodeRabbit

  • Documentation
    • Enhanced OpenAPI specification badge display in README with improved rendering for better visual presentation and documentation clarity.

✏️ Tip: You can customize this high-level summary in your review settings.

Replaced OpenAPI badge with a validator link.
@RobinTail RobinTail added documentation Improvements or additions to documentation external bug it's a bug, but in a dependency labels Nov 21, 2025
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Nov 21, 2025

Warning

Rate limit exceeded

@RobinTail has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 13 minutes and 57 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 7ee9627 and 0cb732e.

📒 Files selected for processing (1)
  • README.md (1 hunks)

Walkthrough

The README.md file was updated to change the OpenAPI badge rendering. The Swagger URL badge was replaced with an inline image element using validator.swagger.io, modifying only the badge presentation without affecting any functional code or documentation content.

Changes

Cohort / File(s) Change Summary
Documentation Badge Update
README.md
Replaced OpenAPI Swagger badge URL reference with inline image element using validator.swagger.io for alternative badge rendering

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

  • Single documentation file modified with cosmetic badge change
  • No functional code alterations
  • No logic or dependency impacts

Poem

🐰 A badge hops from Swagger's URL so neat,
To validator.swagger's image—now sweet!
In README's garden, the change is so small,
Yet prettier badges brighten us all! ✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Readme: replace OpenAPI badge' directly and accurately describes the main change in the pull request, which is replacing the OpenAPI badge in the README file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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 and usage tips.

@coveralls-official
Copy link
Copy Markdown

coveralls-official Bot commented Nov 21, 2025

Coverage Status

coverage: 100.0%. remained the same
when pulling 0cb732e on RobinTail-patch-3
into 5656376 on master.

@RobinTail RobinTail marked this pull request as ready for review November 21, 2025 20:19
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (1)
README.md (1)

6-6: Consider maintaining markdown badge syntax consistency.

Line 6 uses raw HTML (<img>) while all surrounding badges (lines 5, 7, 9–12) use markdown syntax (![label](url)). Although the HTML approach addresses the shields.io outage, mixing formats reduces consistency.

If validator.swagger.io supports markdown image syntax without the height attribute, consider aligning with the surrounding badge style for visual and source consistency. Alternatively, convert all badges in this section to HTML if you prefer explicit sizing control.

If markdown rendering is needed, verify whether validator.swagger.io's image response scales appropriately without an explicit height attribute specified in HTML.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3c6a861 and 7ee9627.

📒 Files selected for processing (1)
  • README.md (1 hunks)
🧰 Additional context used
🧠 Learnings (6)
📚 Learning: 2025-05-27T20:03:34.213Z
Learnt from: RobinTail
Repo: RobinTail/express-zod-api PR: 2546
File: example/factories.ts:35-42
Timestamp: 2025-05-27T20:03:34.213Z
Learning: The `./example` directory in the express-zod-api repository contains demonstration code for educational purposes only, not intended for production use. Example code can make simplified assumptions for brevity and clarity, and should not be flagged for missing production-level error handling, security measures, or edge case handling.

Applied to files:

  • README.md
📚 Learning: 2025-06-02T21:11:20.768Z
Learnt from: RobinTail
Repo: RobinTail/express-zod-api PR: 2697
File: CHANGELOG.md:5-5
Timestamp: 2025-06-02T21:11:20.768Z
Learning: In the express-zod-api repository, RobinTail follows a release workflow where package.json version is only updated on the master branch after merging all planned release changes. Changelog entries may show future version numbers while package.json remains at the previous version during feature development, and this is intentional workflow, not a version inconsistency that needs to be flagged.

Applied to files:

  • README.md
📚 Learning: 2025-05-27T19:35:57.357Z
Learnt from: RobinTail
Repo: RobinTail/express-zod-api PR: 2546
File: express-zod-api/tests/buffer-schema.spec.ts:32-37
Timestamp: 2025-05-27T19:35:57.357Z
Learning: In the express-zod-api project, tests are run from the `express-zod-api` workspace directory, and the project uses an ESM-first environment without `__dirname`. Relative paths like `../logo.svg` in test files correctly resolve to the repository root due to this test execution context.

Applied to files:

  • README.md
📚 Learning: 2025-08-05T14:43:24.702Z
Learnt from: RobinTail
Repo: RobinTail/express-zod-api PR: 2869
File: zod-plugin/package.json:42-44
Timestamp: 2025-08-05T14:43:24.702Z
Learning: Zod version 4 has been officially released and is stable. As of August 2025, the latest published version is 4.0.14 (published July 30, 2025). Zod v4 is available on npm and can be used in peer dependencies with version constraints like "^4.0.0".

Applied to files:

  • README.md
📚 Learning: 2025-05-27T19:27:13.492Z
Learnt from: RobinTail
Repo: RobinTail/express-zod-api PR: 2546
File: express-zod-api/tests/form-schema.spec.ts:31-31
Timestamp: 2025-05-27T19:27:13.492Z
Learning: Zod version 3.25.0 and later expose the Zod v4 API through the special import paths "zod/v4" and "zod/v4/core", allowing v4 features like .loose() to be used even when the package.json dependency shows a 3.x version.

Applied to files:

  • README.md
📚 Learning: 2025-09-29T03:35:55.561Z
Learnt from: RobinTail
Repo: RobinTail/express-zod-api PR: 0
File: :0-0
Timestamp: 2025-09-29T03:35:55.561Z
Learning: In the express-zod-api repository, packages are built using tsdown before publishing. Source code with .ts extensions is not published - only the built JavaScript bundles and declaration files in the dist/ directory are published to npm. This means .ts extensions in source imports don't affect consumers.

Applied to files:

  • README.md

RobinTail added a commit that referenced this pull request Nov 21, 2025
Proof
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img
Related to #3077 

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Style**
* Updated the Contributors section with adjusted list formatting and
contributor avatar sizing for improved display consistency.

<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Removed duplicate OpenAPI validator image from README.
@RobinTail RobinTail merged commit f9f2080 into master Nov 21, 2025
10 checks passed
@RobinTail RobinTail deleted the RobinTail-patch-3 branch November 21, 2025 20:34
RobinTail added a commit that referenced this pull request Nov 23, 2025
RobinTail added a commit that referenced this pull request Nov 23, 2025
Reverts #3077
Seems to be fixed

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
  * Updated OpenAPI badge references in documentation.

<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation external bug it's a bug, but in a dependency

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant