Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
73aefb3
docs: add v2 SDK pages with linked legacy v1 archive
roncohen Nov 15, 2026
3d3bb13
fix: preserve SDK heading anchors in GitBook
roncohen Nov 15, 2026
bf6511e
fix: keep deep SDK method anchors addressable in GitBook
roncohen Nov 15, 2026
2bae2df
fix: preserve public type anchors alongside SDK member links
roncohen Nov 15, 2026
8976090
docs: make current SDK guides stand on their own
roncohen Nov 15, 2026
cbddc72
docs: remove reader-facing SDK provenance notices
roncohen Nov 16, 2026
bd9d10a
docs: identify SDK v2 in current page introductions
roncohen Nov 16, 2026
90b2a52
docs: plain-language pass over SDK guides and shared pages
roncohen Nov 16, 2026
00dd0b4
docs: simplify how SDK guides explain flag reads and defaults
roncohen Nov 16, 2026
3d3b61e
docs: separate Multivariate flags from Remote config
roncohen Nov 17, 2026
cba8cfc
docs: clarify Multivariate flags and remote config migration
roncohen Nov 17, 2026
ac7ff2d
docs: use a portable link to the SDK upgrade guide
roncohen Nov 17, 2026
42cf05d
docs: describe upcoming MCP-assisted remote config migration
roncohen Nov 17, 2026
c35d60b
docs: present MCP-assisted remote config migration as available
roncohen Nov 17, 2026
d36da38
docs: align SDK guide structure and tighten handbook wording
roncohen Nov 17, 2026
688a485
docs: lead remote config migration with agent guidance
roncohen Nov 17, 2026
e52208b
docs: restore numbered get-started steps in SDK guides
roncohen Nov 17, 2026
1e0adfc
docs: check remote config usage before planning migration
roncohen Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .generated/sdk-docs/browser-sdk/v1.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

14 changes: 14 additions & 0 deletions .generated/sdk-docs/browser-sdk/v2.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 12 additions & 0 deletions .generated/sdk-docs/node-sdk/v1.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 12 additions & 0 deletions .generated/sdk-docs/node-sdk/v2.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 13 additions & 0 deletions .generated/sdk-docs/react-native-sdk/v0.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 10 additions & 0 deletions .generated/sdk-docs/react-sdk/v1.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 13 additions & 0 deletions .generated/sdk-docs/react-sdk/v2.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 10 additions & 0 deletions .generated/sdk-docs/vue-sdk/v1.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 12 additions & 0 deletions .generated/sdk-docs/vue-sdk/v2.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

9 changes: 9 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Generated SDK copies; authoritative READMEs/comments live in reflagcom/javascript.
sdk/** linguist-generated=true
supported-languages/browser-sdk/** linguist-generated=true
supported-languages/react-sdk/** linguist-generated=true
supported-languages/vue-sdk/** linguist-generated=true
supported-languages/node-sdk/** linguist-generated=true
supported-languages/react-native-sdk/** linguist-generated=true
legacy/v1/*-sdk/** linguist-generated=true
.generated/** linguist-generated=true
16 changes: 16 additions & 0 deletions .github/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,22 @@ Reflag is built to work at the company/organization level right out of the box,

This repository syncs the documentation to [docs.reflag.com](https://docs.reflag.com). For SDK docs, please go to the [javascript repository](https://github.com/reflagcom/javascript) repository.

## SDK documentation ownership

SDK READMEs and source comments are maintained in `reflagcom/javascript`. Current Browser/React/Vue/Node pages are generated into `supported-languages/`; protocol-v1 pages live in `legacy/v1/`. Do not hand-edit their generated bodies. Source/version and file hashes are recorded in `.generated/sdk-docs/`. Current pages assume a new installation. The importer adds one short SDK v2 scope line after the introduction and a legacy/upgrade link at the end; these site-only notes are reapplied on every source sync. Prerelease availability and major-pinned upgrade commands belong in the migration guide. Keep release-readiness status in PRs and the migration guide, not repeated page banners.

Generate one SDK from an explicitly selected, clean source checkout after building declarations and running its canonical `docs.sh`:

```sh
node .github/scripts/sdk-docs.mjs import --source /path/to/built/javascript --package react-sdk
node .github/scripts/check-sdk-docs.mjs
node --test .github/scripts/sdk-docs.test.mjs
```

The importer derives the destination from the package major, preserves historical SDK aliases, and never deletes a tree or overwrites navigation, migration guidance or GitBook settings. Release automation uses the `release` subcommand with an exact tagged-source plan; prereleases do not promote stable documentation automatically. The SDK documentation workflow rebuilds the source commits listed in the manifests and checks representative examples against matching declarations.

This is ordinary page-based navigation. No GitBook variants or additional published spaces are required.

## Quick links

- Ready to get started? [Follow the guide](https://docs.reflag.com/)
Expand Down
Loading
Loading