OPS-1673: Audit & update Integrations & Connections docs - #6811
Conversation
Greptile SummaryThis PR audits and corrects four integration/connection documentation pages against the current product implementation.
Confidence Score: 5/5Pure documentation corrections with no code changes; all factual updates were verified against the codebase before editing. All four files are Markdown documentation only. The changes correct factual inaccuracies (plan-based repo visibility, Azure DevOps support, remote database networking requirements, missing Snowflake frontmatter) and introduce no new behavior or code paths. The "Other Git Providers" cross-reference in connect_to_github.md and the frontmatter description in connect_to_git_providers.md still omit Azure DevOps — these were flagged in previous review comments and remain open. Important Files Changed
Reviews (2): Last reviewed commit: "OPS-1673: audit & correct Integrations/C..." | Re-trigger Greptile |
Merging this PR will not alter performance
Comparing Footnotes
|
Verified the integration/connection docs against the flexgen codebase and fixed inaccuracies: - GitHub: repo visibility is plan-dependent (Free=public, Enterprise=private, Pro=choice), not "private unless you choose public". - Git providers: Azure DevOps is supported; added it to the list. - Database: added a "Connecting a Private or Remote Database" section (IPv4/pooler reachability, Enterprise static-egress allowlisting) and noted the app connects via REFLEX_DB_URL / REFLEX_ASYNC_DB_URL. - Snowflake: added the missing frontmatter (tags + description) so its gallery card renders correctly. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
19f5a93 to
cdbaeb0
Compare
Audit of the AI Builder integration/connection docs against the current flexgen product. Verified flows in code before editing.
Fixes in this PR (verified against code)
connect_to_github.md): repo visibility is plan-dependent — Free repos are public, Enterprise repos are always private, Pro chooses. The old "private unless you make them public" was only true for Pro.connect_to_git_providers.md): added Azure DevOps to the supported list (it's supported via the generic git provider).database.md): added a "Connecting a Private or Remote Database" section (must be internet-reachable; IPv4/connection-pooler tip; Enterprise static-egress allowlisting) and noted the app connects viaREFLEX_DB_URL/REFLEX_ASYNC_DB_URL(derived automatically from the single connection input).snowflake.md): added the missing frontmatter (tags+description) — it had none, so its gallery card rendered without a category/subtitle..mdinintegrations-docs/docs/(integration_list.pydoes anos.listdir), soairtable,hubspot, andlangchainshow as integrations — but none of them are registered inflexgen/integrations/__init__.py, so they don't exist in the product. Either remove these three pages (+ their sidebar entries) or re-register the integrations. Didn't delete unilaterally.Still open for the ticket's DoD
database.mdhas none; the GitHub page's screenshots weren't re-verified against current UI.database.mdsays "Settings drawer (gear icon) → Integrations tab" — I couldn't confirm this path against the current UI; worth a visual check.overview.mdimportsfrom pcweb.pages...while the docs app exposesreflex_docs.pages...; verify which site consumes it.Linear: OPS-1673
🤖 Generated with Claude Code