1. Project Overview & Quickstart (Redocly/LICENSE)
LICENSE
Open-source repository Redocly/LICENSE
Repository Details
- Repository: Redocly/LICENSE
- Primary Language: Code
Note: High-volume repository documentation is actively indexed and synchronized by YakaAI.
2. Official Technical Reference & Guides (Redocly/website)
File: README.md
Redocly website
This repo is the source of the Redocly website (https://redocly.com).
Development
Prerequisites
- Node.js (version specified in
.tool-versions) - npm
Setup
- Install dependencies:
npm install- Start the development server:
npm startAvailable Scripts
npm start- Start the development server using Redocly CLI previewnpm run lint:markdown- Lint markdown filesnpm run lint:markdown:fix- Fix markdown linting issuesnpm run link-marketing-pages- Link a local build of@redocly/marketing-pagesvia yalcnpm run unlink-marketing-pages- Remove the yalc link and restore the registry version
Project Structure
.
βββ docs/ # Documentation content
βββ pages/ # Website pages
βββ static/ # Static assets
βββ images/ # Image assets
βββ blog/ # Blog content
βββ learn/ # Learning resources
βββ @theme/ # Theme componentsRemote content
The /docs/cli, /docs/realm, and /docs/redoc content are sourced from other repositories using the remote content feature.
docs
βββ cli
βββ realm
βββ redocSidebars
The sidebars are located in the root of the repo:
- docs-cli.sidebars.yaml
- docs-realm.sidebars.yaml
- etc...
Contributing
Please ensure your contribution follows our style guidelines:
- Use Prettier for code formatting
- Follow the markdown linting rules defined in
.markdownlint.yaml - Follow the ESLint configuration
License
This project is proprietary. See the LICENSE file for details.
File: docs/index.md
seo: title: About Redocly documentation
Redocly documentation
Welcome to the official Redocly Documentation.
Ready to build something amazing?
{% cards %}
{% card
title="Get started guide"
layout="horizontal"
align="start"
to="/docs/realm/get-started/index.md"
icon="./images/rocket-icon.svg"
iconVariant="filled"
%}
Go live with your docs in minutes using our guided setup
{% /card %}
{% /cards %}
Products
{% cards columns=2 cardMinWidth=300 %}
{% card
title="Realm"
to="realm/index.md"
icon="./images/home-page/realm-logo.svg"
%}
The synthesis of Redocly's premier toolsβRedoc, Revel, and Reefβunited into a single, powerful platform.
{% /card %}
{% card
title="Workflows"
to="../docs-legacy/workflows/changelog.md"
icon="images/home-page/redocly-logo.svg"
%}
Legacy products
{% /card %}
{% card
title="VS Code extension"
to="vscode/index.md"
icon="images/home-page/vscode.svg"
%}
Extension that helps you write, validate, and maintain your OpenAPI documents
{% /card %}
{% /cards %}
Open source
{% cards columns=2 cardMinWidth=300 %}
{% card
title="Redocly CLI"
to="cli"
icon="images/home-page/terminal-icon.svg"
%}
Open source OpenAPI multi-tool to manage, lint, validate and transform your OpenAPI files.
{% /card %}
{% card
title="Redoc Community Edition"
to="redoc"
icon="images/home-page/develop-docs-icon.svg"
%}
A clean and easy way to produce web-ready documentation from an OpenAPI description.
{% /card %}
{% card
title="Respect Community Edition"
to="respect/index.md"
icon="images/respect-icon.png"
%}
A tool to test API sequences described in Arazzo format.
{% /card %}
{% card
title="End user docs"
to="end-user/index.md"
icon="images/user-docs-icon.svg" %}
Guide to the project's user interface.
{% /card %}
{% /cards %}
Learn
{% cards columns=2 cardMinWidth=300 %}
{% card
title="Cafe API example"
to="https://github.com/Redocly/cafe-api"
icon="images/home-page/coffee.svg"
%}
Use our example to learn about OpenAPI or try out some new tools.
{% /card %}
{% card
title="Learn OpenAPI"
to="/learn/openapi/learning-openapi.md"
icon="images/home-page/extension-icon.svg"
%}
Resources for learning more about OpenAPI and how to use it.
{% /card %}
{% card
title="Learn Markdoc"
to="/learn/markdoc/index.md"
icon="images/home-page/markdoc-icon.svg"
%}
Next-generation markup resources and detailed tag library.
{% /card %}
{% card
title="API Guidelines builder"
to="../pages/api-governance/index.md"
icon="images/home-page/checklist-icon.svg"
%}
Use our interactive tool to build linting rules for your API.
{% /card %}
{% /cards %}