Giter VIP home page Giter VIP logo

configcat / docs Goto Github PK

View Code? Open in Web Editor NEW
20.0 6.0 17.0 79.71 MB

A public repository for the ConfigCat documentation. ConfigCat is a hosted feature flag service: https://configcat.com. Manage feature toggles across frontend, backend, mobile, desktop apps. Alternative to LaunchDarkly. Management app + feature flag SDKs.

Home Page: https://configcat.com/docs

Dockerfile 0.04% HTML 0.25% JavaScript 0.47% CSS 0.02% Shell 0.01% MDX 98.01% SCSS 0.24% TypeScript 0.95%
configcat feature-toggle configcat-documentation feature-management feature-flag featureflags docusaurus docs documentation

docs's Introduction

ConfigCat Docs

A public repository for the ConfigCat documentation. https://configcat.com/docs

About ConfigCat

ConfigCat is a feature flag, feature toggle, and configuration management service. That lets you launch new features and change your software configuration remotely without actually (re)deploying code. ConfigCat even helps you do controlled roll-outs like canary releases and blue-green deployments. https://configcat.com

Prerequisites

Latest LTS version of Node.js.

Quick start

  1. Open Terminal/CMD/PowerShell and change directory to /website
    cd website
    
  2. Install packages
    npm install
    
  3. Run
    npm start
    
    Browser window should open automagically. If not, visit: http://localhost:3000

Guides for Docusaurus

https://docusaurus.io/

Guide for Schema markups

Schema markups helps improving the SEO of the page. There are lots of schema markup types. Currently, we are using the FAQ Page and How-to types.

  1. Generation You can generate schema markups at e.g.: https://technicalseo.com/tools/schema-markup-generator
    After generating the schema markup, you should copy and paste the json content from the generated script to a .json file. Only the .json part should be copied, the script tag will be inserted when we use it later.
    The .json file's location should be under the website/src/schema-markup/... folder. Please use the same directory structure just like at the docs part.

  2. Usage In the files you can inject the schema markup with a similar code:

export const NetSchema = require('@site/src/schema-markup/sdk-reference/net.json');
<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{ __html: JSON.stringify(NetSchema) }}
></script>;

Run locally using Docker

  1. Have Docker CLI installed

  2. Crate container

    docker build -t docs:latest .
  3. Run container (you might need to replace environment variables)

    docker run -i --publish 8000:80 --name docs docs:latest
  4. Open http://localhost:8000

Contributions

Contributions are welcome via PR.

Troubleshooting

Make sure you have the proper Node.js version installed

You might run into errors caused by the wrong version of Node.js. To make sure you are using the recommended Node.js version follow these steps.

  1. Have nvm (Node Version Manager - https://github.com/nvm-sh/nvm ) installed:
  2. Run nvm install. This will install the compatible version of Node.js.
  3. Run nvm use. This will use the compatible version of Node.js.
  4. Your local Node.js version (node -v) should be the same as in the .nvmrc file.

Questions & Support

We are happy to help. https://configcat.com/support

docs's People

Contributors

adams85 avatar bigmirc avatar ccatati avatar charliemacnamara avatar clemblanco avatar codedbychavez avatar configcat-developer avatar david-zoltan avatar dependabot[bot] avatar endret avatar jonasalfredsson avatar kp-cat avatar lajos88 avatar laliconfigcat avatar mr-sige avatar neibesh avatar novalisdenahi avatar pasotee avatar samrushton avatar sigewuzhere avatar tarasyarema avatar tomjrodrigues avatar vladspatariu avatar z4kn4fein avatar zoltan-david avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

docs's Issues

Migrate Website to Docusaurus 2 Alpha

Hi there (@configcat, @david-zoltan and others)! The Docusaurus team is currently developing Docusaurus 2 and are almost done with an MVP that doesn't include translations and versioning features, which means there's feature parity with your website's current usage of Docusaurus.

Docusaurus 2 brings about many improvements:

  • Client-side rendering with prerendering (site renders without JavaScript!)
  • More flexible appearance - Customizable layouts, CSS modules, etc
  • Embeddable interactive React components within markdown via MDX

I will be your POC in helping you throughout the migration process. Let me know what you think!

cc @yangshun @endiliey @wgao19

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.