Skip to content

chore(docs): add scorecard, deepwiki and socket.dev badges#260

Merged
aaguiarz merged 1 commit into
mainfrom
chore/add-badges
Sep 19, 2025
Merged

chore(docs): add scorecard, deepwiki and socket.dev badges#260
aaguiarz merged 1 commit into
mainfrom
chore/add-badges

Conversation

@aaguiarz

@aaguiarz aaguiarz commented Sep 19, 2025

Copy link
Copy Markdown
Member

Description

What problem is being solved?

How is it being solved?

What changes are made to solve it?

References

Review Checklist

  • I have clicked on "allow edits by maintainers".
  • I have added documentation for new/changed functionality in this PR or in a PR to openfga.dev [Provide a link to any relevant PRs in the references section above]
  • The correct base branch is being used, if not main
  • I have added tests to validate that the change in functionality is working as expected

Summary by CodeRabbit

  • Documentation
    • Updated badges: replaced Release and License with Socket and DeepWiki; merged Release onto the DeepWiki line; renamed Twitter to X; added an OpenSSF Scorecard badge after FOSSA.
    • Clarified Batch Check behavior: result order is not guaranteed; use correlationId to pair responses with requests.
    • Noted that changes are documentation/branding only; no functional or API modifications.

@aaguiarz
aaguiarz requested review from a team as code owners September 19, 2025 14:17
@coderabbitai

coderabbitai Bot commented Sep 19, 2025

Copy link
Copy Markdown

Walkthrough

README updated: badges changed/added (Socket, DeepWiki with Release on same line, X rename, OpenSSF Scorecard after FOSSA), and a documentation note under Batch Check clarifying result order is not guaranteed and recommending correlationId. No code, API, or exported entity changes.

Changes

Cohort / File(s) Summary
Docs & badges refresh
README.md
Replaced/added badges (Socket, DeepWiki, OpenSSF Scorecard; Twitter→X; Release repositioned). Added Batch Check note: results ordering not guaranteed; use correlationId to pair responses. No functional changes.

Sequence Diagram(s)

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Suggested reviewers

  • rhamzeh

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.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
Title Check ✅ Passed The title succinctly and accurately summarizes the primary change — adding Scorecard, DeepWiki, and socket.dev badges to documentation — which directly matches the README updates and the PR objectives; it is concise, specific to docs, and free of noisy or vague wording.
✨ Finishing touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch chore/add-badges

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.

@codecov-commenter

codecov-commenter commented Sep 19, 2025

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.16%. Comparing base (b811c2d) to head (6fe63ee).
⚠️ Report is 63 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #260   +/-   ##
=======================================
  Coverage   88.16%   88.16%           
=======================================
  Files          23       23           
  Lines        1217     1217           
  Branches      216      216           
=======================================
  Hits         1073     1073           
  Misses         86       86           
  Partials       58       58           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@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: 0

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

4-5: Badges: OK; avoid data-URI logo for DeepWiki (may not render on GitHub/npm).

Inline base64 logos can be blocked by CSP and bloat the line. Prefer a Shields text badge (or a hosted logo) to ensure consistent rendering.

Preview the README on GitHub and npmjs to confirm the DeepWiki badge renders. If not, apply:

-[![DeepWiki](https://img.shields.io/badge/DeepWiki-openfga%2Fjs--sdk-blue.svg?logo=data:image/png;base64,...) ](https://deepwiki.com/openfga/js-sdk)[![Release](https://img.shields.io/github/v/release/openfga/js-sdk?sort=semver&color=green)](https://github.com/openfga/js-sdk/releases)
+[![DeepWiki](https://img.shields.io/badge/DeepWiki-openfga%2Fjs--sdk-blue)](https://deepwiki.com/openfga/js-sdk)[![Release](https://img.shields.io/github/v/release/openfga/js-sdk?sort=semver&color=green)](https://github.com/openfga/js-sdk/releases)

7-7: OpenSSF Scorecard: pin to default branch for stability.

Add branch to both badge and viewer to avoid ambiguous/default-branch drift.

-[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/openfga/js-sdk/badge)](https://securityscorecards.dev/viewer/?uri=github.com/openfga/js-sdk)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/openfga/js-sdk/badge?branch=main)](https://securityscorecards.dev/viewer/?uri=github.com/openfga/js-sdk&branch=main)

9-9: Use the X logo to match the platform rename.

Minor visual polish; current badge uses the Twitter logo while linking to x.com.

-[![X](https://img.shields.io/twitter/follow/openfga?color=%23179CF0&logo=twitter&style=flat-square "@openfga on Twitter")](https://x.com/openfga)
+[![X](https://img.shields.io/twitter/follow/openfga?color=%23179CF0&logo=x&style=flat-square "Follow @openfga on X")](https://x.com/openfga)

66-66: Rename “Twitter” to “X” for consistency with the badge/link.

Keep branding consistent across README.

-- [Twitter](https://twitter.com/openfga)
+- [X](https://x.com/openfga)

453-454: Good note; clarify correlationId uniqueness.

Nice addition. Suggest clarifying that correlationId should be unique per check item to avoid collisions.

-> **Note**: The order of `batchCheck` results is not guaranteed to match the order of the checks provided. Use `correlationId` to pair responses with requests.
+> **Note**: The order of `batchCheck` results is not guaranteed to match the order of the checks provided. Use a unique `correlationId` per check to pair responses with requests.

472-474: Typo: “correliationId” → “correlationId”.

Fix the misspelling in the example comment.

-        // optional correliationId to associate request and response. One will be generated
+        // optional correlationId to associate request and response. One will be generated
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b811c2d and 6fe63ee.

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

@aaguiarz aaguiarz changed the title chore: add scorecard, deepwiki and socket.dev badges chore(docs): add scorecard, deepwiki and socket.dev badges Sep 19, 2025
@aaguiarz
aaguiarz enabled auto-merge September 19, 2025 14:25
@aaguiarz
aaguiarz added this pull request to the merge queue Sep 19, 2025
Merged via the queue into main with commit 3a79294 Sep 19, 2025
21 checks passed
@aaguiarz
aaguiarz deleted the chore/add-badges branch September 19, 2025 14:49
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.

3 participants