From 0fb11e59de235e4e1927245d7a33c870b208c8e1 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Tue, 14 Nov 2023 11:29:59 +0000 Subject: [PATCH 01/15] fix: Remove github token with incorrect access --- .github/workflows/vale.yaml | 2 -- 1 file changed, 2 deletions(-) diff --git a/.github/workflows/vale.yaml b/.github/workflows/vale.yaml index c5220c419e..e955dc2529 100644 --- a/.github/workflows/vale.yaml +++ b/.github/workflows/vale.yaml @@ -12,5 +12,3 @@ jobs: - uses: errata-ai/vale-action@reviewdog with: files: '["README.md", "docs"]' - env: - GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}} From bb43ba82aaedd0bc5a20b799b47ee81e930a5094 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Tue, 14 Nov 2023 11:39:58 +0000 Subject: [PATCH 02/15] docs: Improve uninstall CTA in migration guide --- docs/guides/migrate-from-redoc-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/migrate-from-redoc-cli.md b/docs/guides/migrate-from-redoc-cli.md index 83520d718a..05003cb310 100644 --- a/docs/guides/migrate-from-redoc-cli.md +++ b/docs/guides/migrate-from-redoc-cli.md @@ -107,5 +107,5 @@ The newer tool has a lot more functionality than `redoc-cli` had, so explore the - Enhancing an OpenAPI description with decorators {% admonition type="warning" name="Uninstall" %} -It's recommended to uninstall `redoc-cli` now that it is no longer needed +We recommend you uninstall `redoc-cli` now that it is no longer needed. {% /admonition %} From f0d9a92f8f0a5c0a154dd53beac35a8b1f3665ad Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Tue, 14 Nov 2023 11:48:56 +0000 Subject: [PATCH 03/15] fix: Update checkout action version for vale --- .github/workflows/vale.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/vale.yaml b/.github/workflows/vale.yaml index e955dc2529..4b04d8896c 100644 --- a/.github/workflows/vale.yaml +++ b/.github/workflows/vale.yaml @@ -8,7 +8,7 @@ jobs: name: vale action runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v4 - uses: errata-ai/vale-action@reviewdog with: files: '["README.md", "docs"]' From 9a5bc065397abcc8b3557f2b2d21eb34d156f92d Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Tue, 14 Nov 2023 12:04:49 +0000 Subject: [PATCH 04/15] docs: Vale reports errors in any edited file --- .github/workflows/vale.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/vale.yaml b/.github/workflows/vale.yaml index 4b04d8896c..84c98366d2 100644 --- a/.github/workflows/vale.yaml +++ b/.github/workflows/vale.yaml @@ -12,3 +12,4 @@ jobs: - uses: errata-ai/vale-action@reviewdog with: files: '["README.md", "docs"]' + filter_mode: file From 981043e8a03d460056ee0878a54c6cee22d67222 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Tue, 14 Nov 2023 13:12:15 +0000 Subject: [PATCH 05/15] docs: Update to make Vale happy --- docs/changelog.md | 2 +- docs/configuration/index.md | 2 +- docs/configuration/rules.md | 2 +- docs/guides/migrate-from-redoc-cli.md | 8 ++++---- docs/guides/migrate-from-swagger-cli.md | 4 ++-- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/changelog.md b/docs/changelog.md index b8742b64c2..a86c97fe26 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -31,7 +31,7 @@ toc: ### Minor Changes - Added the possibility to configure the linting severity level of the configuration file for all CLI commands. - Redocly CLI will exit with an error if there are any issues with the configuration file, and the severity is set to `error`. + Redocly CLI exits with an error if there are any issues with the configuration file, and the severity is set to `error`. ### Patch Changes diff --git a/docs/configuration/index.md b/docs/configuration/index.md index fd70a4a300..fcb60fac6e 100644 --- a/docs/configuration/index.md +++ b/docs/configuration/index.md @@ -78,7 +78,7 @@ Learn about the various sections of the config file, and follow the links for de Use `extends` to adopt an existing [ruleset](../rules.md#rulesets) such as the `recommended` or `minimal` standards. You can also define your own rulesets and refer to them here by file path or URL. -While the order of the sections in the configuration file doesn't matter, usually `extends` is first, and any later rules, preprocessors or decorators defined in this file will override the base settings. +While the order of the sections in the configuration file doesn't matter, usually `extends` is first, and any later rules, preprocessors or decorators defined in this file then override the base settings. Read the [detailed `extends` documentation](./extends.md) to see more information and examples. diff --git a/docs/configuration/rules.md b/docs/configuration/rules.md index 0b580b0478..8b0f9c0400 100644 --- a/docs/configuration/rules.md +++ b/docs/configuration/rules.md @@ -1,4 +1,4 @@ -# Configuring rules +# Configure your linting rules Use individual rules to make the API linting fit your API needs. Start with the [recommended](../rules/recommended.md) or [minimal](../rules/minimal.md) ruleset, then adjust as needed. diff --git a/docs/guides/migrate-from-redoc-cli.md b/docs/guides/migrate-from-redoc-cli.md index 05003cb310..28a77d4782 100644 --- a/docs/guides/migrate-from-redoc-cli.md +++ b/docs/guides/migrate-from-redoc-cli.md @@ -14,7 +14,7 @@ Visit the [installation page](../installation.md) to find and use an installatio All Redocly CLI commands use a common configuration file. For theme options, linting rules, and other configuration, check out the [configuration documentation](../configuration/index.md) for all the details. -### Developing documentation +### Preview documentation locally Replace the old `redoc-cli serve` with: @@ -22,8 +22,8 @@ Replace the old `redoc-cli serve` with: redocly preview-docs --use-community-edition openapi.yaml ``` -The documentation will update when the spec file changes. -By default the documentation is available on `http://127.0.0.1:8080` but this is configurable. +The documentation output updates when the API description changes. +By default the documentation is available on `http://127.0.0.1:8080` but you can configure the host and port. The `--use-community-edition` parameter is needed for the tool to use Redoc to generate the docs; otherwise it generates the preview for our hosted [API reference docs](https://redocly.com/reference/) @@ -31,7 +31,7 @@ The `--use-community-edition` parameter is needed for the tool to use Redoc to g Visit the [`preview-docs` documentation](../commands/preview-docs.md) for more information and examples {% /admonition %} -### Publishing documentation +### Publish documentation Replace existing `redoc-cli build` commands with: diff --git a/docs/guides/migrate-from-swagger-cli.md b/docs/guides/migrate-from-swagger-cli.md index 8094eda3f5..eb6e96d96a 100644 --- a/docs/guides/migrate-from-swagger-cli.md +++ b/docs/guides/migrate-from-swagger-cli.md @@ -27,7 +27,7 @@ You can run these commands locally, as part of your CI (continuous integration) ### Structure validation only -In some cases, the additional rules from linting won't be useful. For instance, in the case of legacy APIs that won't be updated to meet more modern API expectations. To restrict Redocly to only checking that the API description meets the expected structure for OpenAPI, use a `redocly.yaml` file to configure a ruleset that contains only the `spec` rule. +In some cases, checking additional rules during lint is less useful. For instance, in the case of legacy APIs that are no longer updated to meet more modern API expectations. To restrict Redocly to only checking that the API description meets the expected structure for OpenAPI, use a `redocly.yaml` file to configure a ruleset that contains only the `spec` rule. The configuration in the `redocly.yaml` file should look like this: @@ -38,7 +38,7 @@ rule: spec: error ``` -Redocly CLI will automatically detect the configuration file, so your command should be: +Redocly CLI automatically detects the `redocly.yaml` configuration file, so your command should be: ```sh redocly lint openapi.yml From 30e14ed4284bbc2c48d9f49f4e33b49244977801 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Tue, 14 Nov 2023 14:01:34 +0000 Subject: [PATCH 06/15] docs: Markdownlint fixes --- README.md | 14 +++++++------- docs/rules/built-in-rules.md | 4 ++++ 2 files changed, 11 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index fa468c7b6c..3895de01a2 100644 --- a/README.md +++ b/README.md @@ -12,19 +12,19 @@ ### Node -``` +```sh npx @redocly/cli lint path-to-root-file.yaml ``` Alternatively, install it globally with `npm`: -``` +```sh npm install @redocly/cli -g ``` Then you can use it as `redocly [command] [options]`, for example: -``` +```sh redocly lint path-to-root-file.yaml ``` @@ -36,13 +36,13 @@ To give the Docker container access to the OpenAPI description files, you need t mount the containing directory as a volume. Assuming the API description is rooted in the current working directory, you need the following command: -``` +```sh docker run --rm -v $PWD:/spec redocly/cli lint path-to-root-file.yaml ``` To build and run with a local image, run the following from the project root: -``` +```sh docker build -t redocly/cli . docker run --rm -v $PWD:/spec redocly/cli lint path-to-root-file.yaml ``` @@ -53,7 +53,7 @@ docker run --rm -v $PWD:/spec redocly/cli lint path-to-root-file.yaml Redocly CLI is a great way to render API reference documentation. It uses open source [Redoc](https://github.com/redocly/redoc) to build your documentation. Use a command like this: -``` +```sh redocly build-docs openapi.yaml ``` @@ -73,7 +73,7 @@ Our API linter is designed for speed on even large documents, and it's easy to r Try it like this: -``` +```sh redocly lint openapi.yaml ``` diff --git a/docs/rules/built-in-rules.md b/docs/rules/built-in-rules.md index d54f083361..93576ce6bb 100644 --- a/docs/rules/built-in-rules.md +++ b/docs/rules/built-in-rules.md @@ -13,6 +13,10 @@ The _Special rules_ group contains rules that may apply to multiple objects or t Build [configurable rules](./configurable-rules.md) if the rule you need isn't listed. {% /admonition %} +## List of available rules + +Details of all the rules available "out of the box" with Redocly CLI are listed below. Visit each individual page for details of what the rule does, additional configuration options, and examples of it in use. + ### Special rules - [no-unresolved-refs](./no-unresolved-refs.md): Every `$ref` must exist From 8078cc0a27bb59018320b6d8f6679c688683ec14 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Wed, 15 Nov 2023 12:06:54 +0000 Subject: [PATCH 07/15] fix: Remove sync actions as this integration is no longer used --- .github/sync.yml | 3 --- .github/workflows/sync.yml | 18 ------------------ 2 files changed, 21 deletions(-) delete mode 100644 .github/sync.yml delete mode 100644 .github/workflows/sync.yml diff --git a/.github/sync.yml b/.github/sync.yml deleted file mode 100644 index 20b15e3526..0000000000 --- a/.github/sync.yml +++ /dev/null @@ -1,3 +0,0 @@ -Redocly/docs: - - source: docs/ - dest: docs/cli/ \ No newline at end of file diff --git a/.github/workflows/sync.yml b/.github/workflows/sync.yml deleted file mode 100644 index b41aa8795a..0000000000 --- a/.github/workflows/sync.yml +++ /dev/null @@ -1,18 +0,0 @@ -name: Sync Files -on: - push: - branches: - - main - workflow_dispatch: -jobs: - sync: - runs-on: ubuntu-latest - steps: - - name: Checkout Repository - uses: actions/checkout@v2 - - name: Run GitHub File Sync - uses: Redocly/repo-file-sync-action@main - with: - GH_PAT: ${{ secrets.GH_PAT }} - COMMIT_PREFIX: "sync:" - SKIP_PR: true From 748d21ccd2c573d80c7d1e496d6abca0cdd32ecb Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Fri, 17 Nov 2023 08:34:03 +0000 Subject: [PATCH 08/15] core: Add markdownlint config and github action Uses rules from https://github.com/Redocly/marketing-site-portal/pull/1142 --- .github/CONTRIBUTING.md | 12 +++++-- .github/workflows/markdownlint.yml | 15 +++++++++ .markdownlint.yaml | 54 ++++++++++++++++++++++++++++++ 3 files changed, 78 insertions(+), 3 deletions(-) create mode 100644 .github/workflows/markdownlint.yml create mode 100644 .markdownlint.yaml diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 7c82126ab4..e9fb44c681 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -35,7 +35,7 @@ Before submitting a pull request, please make sure the following is done: After forking the repo, run: ```bash -$ npm install # or npm i +npm install # or npm i ``` ### Commonly used NPM scripts @@ -97,17 +97,23 @@ Don't forget to revert the changes to **package.json** files later. We are proud of our docs. When you open a pull request, we lint the prose using [Vale](https://vale.sh/). You can also install this tool locally and run it from the root of the project with: -``` +```bash vale docs/ ``` The configuration is in `.vale.ini` in the root of the project. +### Markdown linting + +We use [Markdownlint](https://github.com/DavidAnson/markdownlint) to check that the Markdown in our docs is well formatted. The checks run as part of the pull request, and you can also run this tool locally. Follow the instructions from the markdownlint project page, and then run `markdownlint docs/` in the top-level folder of this repository. + +> Note that prettier also runs and reformats Markdown files. Use `npm run prettier` from the root of the project. + ### Markdown link checking We use [`mlc`](https://github.com/becheran/mlc) to check the links in the `docs/` folder. This tool runs automatically on every pull request, but you can also run it locally if you want to. Visit the project homepage to find the installation instructions for your platform, and then run the command like this: -``` +```bash mlc docs/ ``` diff --git a/.github/workflows/markdownlint.yml b/.github/workflows/markdownlint.yml new file mode 100644 index 0000000000..c7821ecf78 --- /dev/null +++ b/.github/workflows/markdownlint.yml @@ -0,0 +1,15 @@ +name: Markdown lint +on: + pull_request: + types: [opened, synchronize, reopened] + +jobs: + markdownlint: + name: markdownlint + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: articulate/actions-markdownlint@v1 + with: + config: .markdownlint.yaml + files: 'docs/**/*.md' diff --git a/.markdownlint.yaml b/.markdownlint.yaml new file mode 100644 index 0000000000..ab1a86e51d --- /dev/null +++ b/.markdownlint.yaml @@ -0,0 +1,54 @@ +--- +# Default rules: https://github.com/github/super-linter/blob/master/TEMPLATES/.markdown-lint.yml + +# Rules by id + +# Unordered list style +MD004: false + +# Unordered list indentation +MD007: + indent: 2 + +MD013: + # TODO: Consider to decrease allowed line length + line_length: 800 + tables: false + +## Allow same headers in siblings +MD024: + siblings_only: true + +# Multiple top level headings in the same document +MD025: + front_matter_title: '' + +# Trailing punctuation in heading +MD026: + punctuation: '.,;:。，；:' + +# Ordered list item prefix +MD029: false + +# Unordered lists inside of ordered lists +MD030: false + +# Inline HTML +MD033: false + +# No bare urls +MD034: false + +# Emphasis used instead of a heading +MD036: false + +# Disable "First line in file should be a top level heading" +# We use uncommon format to add metadata. +# TODO: Consider to use "YAML front matter". +MD041: false + +# Rules by tags +blank_lines: false + +MD046: false +# code-block-style From 63e6032f2ca85897e12166226e682790d3b98942 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Fri, 17 Nov 2023 08:35:15 +0000 Subject: [PATCH 09/15] chore: Move contributing file to top level --- .github/CONTRIBUTING.md => CONTRIBUTING.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename .github/CONTRIBUTING.md => CONTRIBUTING.md (100%) diff --git a/.github/CONTRIBUTING.md b/CONTRIBUTING.md similarity index 100% rename from .github/CONTRIBUTING.md rename to CONTRIBUTING.md From 616522b6da5abd446b74a0cb3ff3b86c92cba77f Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Fri, 17 Nov 2023 15:15:52 +0000 Subject: [PATCH 10/15] chore: Add markdown to the file types that we want prettier to operate on --- package.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/package.json b/package.json index dbf072efae..9027482f53 100644 --- a/package.json +++ b/package.json @@ -16,8 +16,8 @@ "coverage:core": "npm run jest -- --roots packages/core/src --coverage", "typecheck": "tsc --noEmit --skipLibCheck", "e2e": "npm run webpack-bundle -- --mode=none && REDOCLY_TELEMETRY=off jest --roots=./__tests__/", - "prettier": "npx prettier --write \"**/*.{ts,js,yaml,json}\"", - "prettier:check": "npx prettier --check \"**/*.{ts,js,yaml,json}\"", + "prettier": "npx prettier --write \"**/*.{ts,js,yaml,json,md}\"", + "prettier:check": "npx prettier --check \"**/*.{ts,js,yaml,json,md}\"", "eslint": "eslint packages/**", "clean": "rm -rf packages/**/lib packages/**/node_modules packages/**/*.tsbuildinfo package-lock.json node_modules", "watch": "tsc -b tsconfig.build.json --watch ", From b5e39edd34ef374cbf953ce8ba8bd5b024ba114e Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Fri, 17 Nov 2023 15:32:56 +0000 Subject: [PATCH 11/15] fix: Make files fit prettier rules, ignore LICENSE since we can't change that --- .prettierignore | 1 + packages/core/README.md | 10 +++++----- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/.prettierignore b/.prettierignore index fbe3d0f6f7..2ec79b782d 100644 --- a/.prettierignore +++ b/.prettierignore @@ -5,3 +5,4 @@ output/ *snapshot.js packages/core/src/rules/__tests__/fixtures/invalid-yaml.yaml __tests__/webpack-bundle/bundle-workflows/metafile.json +LICENSE.md diff --git a/packages/core/README.md b/packages/core/README.md index 9160552c91..b66f3306c6 100644 --- a/packages/core/README.md +++ b/packages/core/README.md @@ -3,10 +3,10 @@ See https://github.com/Redocly/redocly-cli > [!IMPORTANT] -The `openapi-core package` is designed for our internal use; the interfaces that are considered safe to use are documented below. -Some of the function arguments are not documented below because they are not intended for public use. -Avoid using any functions or features that are not documented below. -If your use case is not documented below, please open an issue. +> The `openapi-core package` is designed for our internal use; the interfaces that are considered safe to use are documented below. +> Some of the function arguments are not documented below because they are not intended for public use. +> Avoid using any functions or features that are not documented below. +> If your use case is not documented below, please open an issue. ## Basic usage @@ -265,4 +265,4 @@ Helper function to stringify a javascript object to YAML. ```ts function stringifyYaml(obj: object): string; -``` \ No newline at end of file +``` From bbf3533cd8c064ee1478015e52c0e177626298d9 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Fri, 17 Nov 2023 15:37:43 +0000 Subject: [PATCH 12/15] chore: Combine docs-related workflows into one for simplicity --- .github/workflows/docs-tests.yaml | 35 +++++++++++++++++++++++++++ .github/workflows/markdownlint.yml | 15 ------------ .github/workflows/mlc-link-check.yaml | 17 ------------- .github/workflows/vale.yaml | 15 ------------ 4 files changed, 35 insertions(+), 47 deletions(-) create mode 100644 .github/workflows/docs-tests.yaml delete mode 100644 .github/workflows/markdownlint.yml delete mode 100644 .github/workflows/mlc-link-check.yaml delete mode 100644 .github/workflows/vale.yaml diff --git a/.github/workflows/docs-tests.yaml b/.github/workflows/docs-tests.yaml new file mode 100644 index 0000000000..a1019a06e1 --- /dev/null +++ b/.github/workflows/docs-tests.yaml @@ -0,0 +1,35 @@ +name: Documentation tests +on: + pull_request: + types: [opened, synchronize, reopened] + +jobs: + markdownlint: + name: markdownlint + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: articulate/actions-markdownlint@v1 + with: + config: .markdownlint.yaml + files: 'docs/**/*.md' + + vale: + name: vale action + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: errata-ai/vale-action@reviewdog + with: + files: '["README.md", "docs"]' + filter_mode: file + + linkcheck: + runs-on: ubuntu-latest + steps: + - name: Checkout Repository + uses: actions/checkout@v4 + - name: Markup Link Checker (mlc) + uses: becheran/mlc@v0.16.1 + with: + args: ./docs diff --git a/.github/workflows/markdownlint.yml b/.github/workflows/markdownlint.yml deleted file mode 100644 index c7821ecf78..0000000000 --- a/.github/workflows/markdownlint.yml +++ /dev/null @@ -1,15 +0,0 @@ -name: Markdown lint -on: - pull_request: - types: [opened, synchronize, reopened] - -jobs: - markdownlint: - name: markdownlint - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - uses: articulate/actions-markdownlint@v1 - with: - config: .markdownlint.yaml - files: 'docs/**/*.md' diff --git a/.github/workflows/mlc-link-check.yaml b/.github/workflows/mlc-link-check.yaml deleted file mode 100644 index 08ded39b55..0000000000 --- a/.github/workflows/mlc-link-check.yaml +++ /dev/null @@ -1,17 +0,0 @@ -name: Check links -on: - pull_request: - types: [opened, synchronize, reopened] - push: - branches: - - main -jobs: - linkcheck: - runs-on: ubuntu-latest - steps: - - name: Checkout Repository - uses: actions/checkout@v2 - - name: Markup Link Checker (mlc) - uses: becheran/mlc@v0.16.1 - with: - args: ./docs diff --git a/.github/workflows/vale.yaml b/.github/workflows/vale.yaml deleted file mode 100644 index 84c98366d2..0000000000 --- a/.github/workflows/vale.yaml +++ /dev/null @@ -1,15 +0,0 @@ -name: Docs lint -on: - pull_request: - types: [opened, synchronize, reopened] - -jobs: - vale: - name: vale action - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - uses: errata-ai/vale-action@reviewdog - with: - files: '["README.md", "docs"]' - filter_mode: file From c80c8356bf103ce89d582d88aac202116cccc122 Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Fri, 17 Nov 2023 16:07:27 +0000 Subject: [PATCH 13/15] docs: Add instructions for running the CLI docs standalone from this repo --- CONTRIBUTING.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e9fb44c681..19daf74489 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -93,6 +93,16 @@ Don't forget to revert the changes to **package.json** files later. ## Contribute documentation +Additions and updates to our documentation are very welcome. You can find the documentation in the `docs/` folder, and this is published to https://redocly.com/docs/cli/ as part of our main website. + +To preview your changes locally, run this command from the `docs/` folder: + +```bash +https://redocly.com/docs/cli/ +``` + +> Please note that currently the custom markdoc tags used in the main website are not available in the local preview version, and links that point to the wider website do show as errors when using a local platform. The pull request workflows generate a full preview, so rest assured that you are able to check everything is in good shape before we review and merge your changes. + ### Prose linting We are proud of our docs. When you open a pull request, we lint the prose using [Vale](https://vale.sh/). You can also install this tool locally and run it from the root of the project with: From 66770ed6690340deec9caf83c037c2887886240b Mon Sep 17 00:00:00 2001 From: Lorna Mitchell Date: Mon, 20 Nov 2023 13:59:44 +0000 Subject: [PATCH 14/15] chore: Add changeset, this docs change is quite large --- .changeset/bright-steaks-walk.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/bright-steaks-walk.md diff --git a/.changeset/bright-steaks-walk.md b/.changeset/bright-steaks-walk.md new file mode 100644 index 0000000000..ec77426747 --- /dev/null +++ b/.changeset/bright-steaks-walk.md @@ -0,0 +1,5 @@ +--- +"@redocly/cli": patch +--- + +feat: Support standalone docs development to facilitate more contributors, add docs quality checks to CI From f753c86c3c8b573858c6b419a2b9f6c0bc6ea65c Mon Sep 17 00:00:00 2001 From: Lorna Jane Mitchell Date: Mon, 20 Nov 2023 14:57:35 +0000 Subject: [PATCH 15/15] Update .changeset/bright-steaks-walk.md Co-authored-by: Ihor Karpiuk <106662428+IgorKarpiuk@users.noreply.github.com> --- .changeset/bright-steaks-walk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.changeset/bright-steaks-walk.md b/.changeset/bright-steaks-walk.md index ec77426747..8165a1e29c 100644 --- a/.changeset/bright-steaks-walk.md +++ b/.changeset/bright-steaks-walk.md @@ -2,4 +2,4 @@ "@redocly/cli": patch --- -feat: Support standalone docs development to facilitate more contributors, add docs quality checks to CI +Support standalone docs development to facilitate more contributors, add docs quality checks to CI.