Instruction file imported from kp-cat/configcat-docs (
.github/instructions/*.instructions.md). Copyright stays with the author.
Project Overview
This is the ConfigCat documentation repository, a Docusaurus-based documentation site for ConfigCat's feature flag and configuration management service. The site is available at https://configcat.com/docs.
Architecture
Key Technologies
- Docusaurus 3.8+
- TypeScript
- OpenAPI docs plugins
- Public Management API: https://api.configcat.com/docs/v1/swagger.json
- SCIM API: https://scim-api.configcat.com/openapi/v1/openapi.json
- Algolia
- SASS
Documentation Versioning
The site maintains two versions:
- Config V2 (current) - Default version at
/docs/ - Config V1 (legacy) - Available at
/docs/V1/, excluded from sitemap
Directory Structure
website/docs/- Main documentation content (MDX files)sdk-reference/- Documentation of ConfigCat SDKs for various platformsintegrations/- Integration guidesadvanced/- Guides on advanced topicstargeting/- Targeting and feature flag evaluation docsglossary/- Glossary of terms
website/api/- ConfigCat Public Management API documentation contentwebsite/src/- React components, custom CSS, and pluginscomponents/- Reusable React componentsschema-markup/- JSON-LD schema markup files for SEOpages/- Custom pagescss/- Custom SCSS styles
website/static/- Static assets (images, etc.)website/versioned_docs/- Config V1 documentationwebsite/sidebars.ts- Main sidebar configuration (defines navigation structure)website/docusaurus.config.ts- Docusaurus configuration
Important Configuration Details
- Base URL:
/docs/(not root) - Trailing slashes: Enabled
- Multi-language support: Configured but only English enabled
Review Focus
When reviewing documentation changes, check for:
- Typos and grammatical errors.
- Adherence to the writing style and text formatting guidelines defined by ConfigCat's Guidelines for Text.
- Accuracy of any code snippets or technical instructions.