Skip to content

docs: update links for local evaluation and edge proxy docs#7961

Merged
Zaimwa9 merged 7 commits into
Flagsmith:mainfrom
nattiechan:docs/edge-proxy-improvements
Jul 13, 2026
Merged

docs: update links for local evaluation and edge proxy docs#7961
Zaimwa9 merged 7 commits into
Flagsmith:mainfrom
nattiechan:docs/edge-proxy-improvements

Conversation

@nattiechan

@nattiechan nattiechan commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Thanks for submitting a PR! Please check the boxes below:

  • I have read the Contributing Guide.
  • I have added information to docs/ if required so people know about the feature.
  • I have filled in the "Changes" section below.
  • I have filled in the "How did you test this code" section below.

Changes

Based on my experience implementing Flagsmith Client SDK, and Server SDK via edge proxy, I decided to update some of the documentation around local evaluation and edge proxy to clear up some confusion I had during the implementation. The contribution stemmed from this discord message: https://discord.com/channels/517647859495993347/917719343930957846/1521555745798226093

  • Update links for local evaluation and caveats to a more specific section for more context
  • Add a bullet point on identity override troubleshooting for edge proxy

I also updated the openAPI docs accordingly per README in /docs, though unsure if I have done it correctly.

How did you test this code?

Ran server locally via make serve to visualize the changes locally.

@nattiechan nattiechan requested a review from a team as a code owner July 8, 2026 01:45
@nattiechan nattiechan requested review from matthewelwell and removed request for a team July 8, 2026 01:45
@vercel

vercel Bot commented Jul 8, 2026

Copy link
Copy Markdown

@nattiechan is attempting to deploy a commit to the Flagsmith Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

This pull request updates documentation link targets from an older integration-overview URL structure to SDK-specific anchors for Local Evaluation Mode and Environment Document references across several docs pages. It also adds new Edge Proxy api_url documentation and troubleshooting content, introduces a new SDK API tag page with sidebar wiring, and regenerates encoded API payloads and JSON schemas for multiple SDK API reference pages.

Estimated code review effort: 2 (Simple) | ~15 minutes

Changes

File(s) Summary
billing-api-usage.md, governance-and-compliance/api-usage.md, defensive-coding.md, efficient-api-usage.md, getting-started/glossary.md, integrating-with-flagsmith/sdks/index.md, performance/edge-proxy.md Updated Local Evaluation Mode / Environment Document link targets to SDK-specific anchors
deployment-self-hosting/edge-proxy.md Added api_url config documentation and a troubleshooting bullet
sdk-api/sdk.tag.mdx, sdk-api/sidebar.ts Added new SDK API tag page and sidebar link
sdk-api/flagsmith-api.info.mdx, sdk-api/sdk-v-1-environment-document.api.mdx, sdk-api/sdk-v-1-flags.api.mdx, sdk-api/sdk-v-1-get-identities.api.mdx, sdk-api/sdk-v-1-post-identities.api.mdx Regenerated encoded API payloads and updated response/request JSON schemas

Sequence Diagram(s)

Not applicable — this PR consists of documentation link/content updates and regenerated API reference schemas with no observable runtime interaction flow.

Related issues: None specified.

Related PRs: None specified.

Suggested labels: documentation

Suggested reviewers: None specified.


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

@github-actions github-actions Bot added the docs Documentation updates label Jul 8, 2026
The current link does not link to relevant
content, so this commit fixes the issue
- Add default info to `api_url` config
- Add more info on identity override
troubleshooting
Update the links to local evaluation mode
to be more specific depending on the
context
There is a more comprehensive link in SDK overview,
so using that one instead
@nattiechan nattiechan force-pushed the docs/edge-proxy-improvements branch from 0a9a01e to 5dad1e3 Compare July 8, 2026 01:50

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


ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 9f45b787-8937-428e-85c2-af8abc9a2a9f

📥 Commits

Reviewing files that changed from the base of the PR and between da194ca and 0a9a01e.

📒 Files selected for processing (15)
  • docs/docs/administration-and-security/billing-api-usage.md
  • docs/docs/administration-and-security/governance-and-compliance/api-usage.md
  • docs/docs/best-practices/defensive-coding.md
  • docs/docs/best-practices/efficient-api-usage.md
  • docs/docs/deployment-self-hosting/edge-proxy.md
  • docs/docs/getting-started/glossary.md
  • docs/docs/integrating-with-flagsmith/sdks/index.md
  • docs/docs/performance/edge-proxy.md
  • docs/docs/sdk-api/flagsmith-api.info.mdx
  • docs/docs/sdk-api/sdk-v-1-environment-document.api.mdx
  • docs/docs/sdk-api/sdk-v-1-flags.api.mdx
  • docs/docs/sdk-api/sdk-v-1-get-identities.api.mdx
  • docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx
  • docs/docs/sdk-api/sdk.tag.mdx
  • docs/docs/sdk-api/sidebar.ts

Comment thread docs/docs/best-practices/defensive-coding.md
Comment thread docs/docs/deployment-self-hosting/edge-proxy.md Outdated
@nattiechan nattiechan marked this pull request as draft July 8, 2026 01:50
@nattiechan nattiechan marked this pull request as ready for review July 8, 2026 01:54

@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


ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: d10c31f1-548e-46db-90cc-06ec405d61aa

📥 Commits

Reviewing files that changed from the base of the PR and between 0a9a01e and 05459ee.

📒 Files selected for processing (15)
  • docs/docs/administration-and-security/billing-api-usage.md
  • docs/docs/administration-and-security/governance-and-compliance/api-usage.md
  • docs/docs/best-practices/defensive-coding.md
  • docs/docs/best-practices/efficient-api-usage.md
  • docs/docs/deployment-self-hosting/edge-proxy.md
  • docs/docs/getting-started/glossary.md
  • docs/docs/integrating-with-flagsmith/sdks/index.md
  • docs/docs/performance/edge-proxy.md
  • docs/docs/sdk-api/flagsmith-api.info.mdx
  • docs/docs/sdk-api/sdk-v-1-environment-document.api.mdx
  • docs/docs/sdk-api/sdk-v-1-flags.api.mdx
  • docs/docs/sdk-api/sdk-v-1-get-identities.api.mdx
  • docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx
  • docs/docs/sdk-api/sdk.tag.mdx
  • docs/docs/sdk-api/sidebar.ts

Comment thread docs/docs/sdk-api/sdk-v-1-post-identities.api.mdx
@vercel

vercel Bot commented Jul 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 13, 2026 10:00am

Request Review

@Zaimwa9 Zaimwa9 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.

Thanks for the contribution! Ignoring the coderabbit comment as this comes from an existing drift.
Follow up issue created accordingly here

@Zaimwa9 Zaimwa9 merged commit f9560b6 into Flagsmith:main Jul 13, 2026
6 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants