Commit Graph

149 Commits

Author SHA1 Message Date
ArkBriar
9456460f77 chore: replace ➡️ with 🔀 to align the words (#1595)
* remove unexpected extra space before Path Items

Signed-off-by: arkbriar <arkbriar@gmail.com>

* Use 🔀 instead of ➡️

Signed-off-by: arkbriar <arkbriar@gmail.com>

* chore: add a changeset

---------

Signed-off-by: arkbriar <arkbriar@gmail.com>
Co-authored-by: Lorna Mitchell <lorna.mitchell@redocly.com>
2024-06-21 10:40:08 +01:00
Lorna Jane Mitchell
546d482b03 feat: add markdown output format for lint command (#1559)
* feat: Add markdown output format for lint command

* feat: Tweak output and add a test

* fix: send markdown output to stdout to match existing json/checkstyle behaviour

* fix: Update snapshots

* fix: Check error count to determine success

* docs: Add markdown format docs to lint command page

* chore: Add changeset

* Apply suggestions from code review

Co-authored-by: Heather Cloward <heathercloward@gmail.com>

* docs: Update from review feedback

* fix: Add missing image, run prettier

* fix: Update test to match corrected code behaviour

---------

Co-authored-by: Heather Cloward <heathercloward@gmail.com>
2024-05-20 09:54:26 +01:00
romana-la
875dfa8d8b docs: replace relative links leading outside of the directory (#1515)
Co-authored-by: Lorna Jane Mitchell <github@lornajane.net>
2024-05-08 11:15:57 +01:00
Dmytro Anansky
b0b50da1e8 feat: remove --lint, --preprocess, and --decorate options from the join command (#1507) 2024-04-04 15:50:07 +03:00
Dmytro Anansky
9343b35cdd feat: drop linting option from bundle command (#1503) 2024-04-02 12:12:16 +03:00
Raymond Jelierse
2d16014b67 feat(lint): add support for GitHub Actions output format (#1497)
* feat(format): add support for GitHub Actions output format

* feat(lint): add support for GitHub Action output format

* doc: add changeset

* style: language hint on codeblock

* fix: include dependency in correct package

* refactor: remove dependency on @actions/core, do formatting of messages internally

* test: add coverage for github-actions output format

* style: format with prettier

* test: update snapshot for lint help output

* chore: update changeset to indicate minor version bump

* fix: undo local reference to @redocly/openapi-core

* Update .changeset/tame-gifts-tease.md

---------

Co-authored-by: Lorna Jane Mitchell <github@lornajane.net>
2024-03-27 15:58:22 +00:00
Dmytro Anansky
bd82bcdd93 feat: command for linting Redocly config itself (#1491)
* feat: linting redocly config itself
2024-03-22 17:31:03 +02:00
Taylor Krusen
d8d83edf59 Removing tabs from join command page (#1492) 2024-03-20 10:31:22 -07:00
Lorna Jane Mitchell
ee55f26c36 docs: Fix a silent failure in the Vale rules, check CI can catch it (#1464) 2024-03-05 11:28:11 +00:00
Lorna Jane Mitchell
fec8220bef docs: Update stats command docs with new markdown output format and a github actions example (#1449)
* docs: Update stats command docs with new markdown output format and a github actions example

* docs: Add screenshot

* Apply suggestions from code review

Co-authored-by: Heather Cloward <heathercloward@gmail.com>

---------

Co-authored-by: Heather Cloward <heathercloward@gmail.com>
2024-02-26 16:51:14 +00:00
Mateusz Lis
838c179e15 docs: remove description for xtaggroup when using join command (#1422)
* docs: update join command docs related to x-taggroups changes

Co-authored-by: Andrew Tatomyr <andrew.tatomyr@redocly.com>

---------

Co-authored-by: Andrew Tatomyr <andrew.tatomyr@redocly.com>
2024-02-14 11:27:02 +01:00
Lorna Jane Mitchell
fd79f7d4c5 docs: Use Museum API instead of Petstore examples (#1386)
* docs: add museum examples to installation and bundle/join commands

* docs: removed petstore examples and updated formatting for readability

* docs: Update petstore to museum examples in decorators section

* chore: Prettier wants to fix a file

* chore: Fix Vale-detected future tense mistakes

* Update docs/decorators/media-type-examples-override.md

* Update docs/commands/lint.md

* Update docs/commands/lint.md

---------

Co-authored-by: Heather Cloward <heathercloward@gmail.com>
2024-02-12 18:06:11 +00:00
volodymyr-rutskyi
4ff9eb64c1 docs: preview command (#1384) 2024-01-23 12:49:56 +02:00
Ihor Karpiuk
588b956d85 chore: deprecate lint option in the join command (#1349) 2023-12-14 18:09:40 +02:00
Ihor Karpiuk
79936f2bb3 chore: add deprecate warning for the lint-related options (#1342)
Co-authored-by: Lorna Jane Mitchell <github@lornajane.net>
2023-11-29 11:06:10 +02:00
Lorna Jane Mitchell
de80612b55 chore: Run prettier on all docs files (#1334) 2023-11-17 09:45:03 +00:00
redocly-bot
d008291a32 sync: Synced local 'docs/' with remote 'docs/cli/' 2023-11-09 15:56:27 +00:00
Andrew Tatomyr
4620f79f29 feat: add built-in recommeded-strict ruleset (#1311) 2023-10-26 15:07:19 +03:00
Ihor Karpiuk
1510e471b7 feat: extend split and join commands to produce JSON output (#1305) 2023-10-26 14:42:06 +03:00
Ihor Karpiuk
0c52110c80 chore: set default severity for lint config (#1292) 2023-10-19 16:23:18 +03:00
redocly-bot
9199b2bab7 sync: Synced local 'docs/' with remote 'docs/cli/' 2023-10-09 16:35:49 +00:00
Adam Altman
0a73f1f557 refactor: rename to API description for consistency (#1239) 2023-09-18 15:22:26 +02:00
Lorna Jane Mitchell
daf030b7a8 Custom plugin documentation (#1222)
* Remove extra 'resources' landing page, redirect from main one

* Move custom plugins file to its own directory, add redirect to handle

* docs: split the custom plugins page into one page per feature

* docs: extend decorators explanation and link to it from the custom plugins section

* docs: Fix all the links that were broken when I moved things

* Apply excellent suggestions from code review

Co-authored-by: Heather Cloward <heathercloward@gmail.com>

* docs: Add examples of how to use the custom rule

* docs: Replace the nested visitor example with an object rather than a function

* Update custom-rules.md

minor consistency edits

* Apply suggestions from code review

Co-authored-by: Heather Cloward <heathercloward@gmail.com>

* docs: clearer explanation of skip, and finish a broken sentence

* Update docs/custom-plugins/index.md

Co-authored-by: Heather Cloward <heathercloward@gmail.com>

* Apply suggestions from code review

Co-authored-by: Adam Altman <adam@redoc.ly>

* docs: use object rather than function for visitor

---------

Co-authored-by: Heather Cloward <heathercloward@gmail.com>
Co-authored-by: Adam Altman <adam@redoc.ly>
2023-08-16 14:26:56 +01:00
Lorna Jane Mitchell
0de4e7c9bb Refresh lint article (#1102)
* docs: tidy up lint doc, add JSON format

Rescue some changes from #665 that are worth keeping, and signpost the
rules documentation for configuration examples rather than having that
information duplicated here.

* docs: default value with variable description, anchors for renamed headings
2023-07-18 11:32:43 +01:00
Lorna Jane Mitchell
9dc78a6d3f docs: Improve CLI usage wording (#1162)
* chore: Tidy up usage options and wording

* docs: Update/refresh command docs pages, add completion page

* chore: run prettier

* fix: keep the previous push command format for backward compatibility

* fix: update test snapshots to match new usage output

* chore: run prettier

* Apply suggestions from code review

Co-authored-by: Heather Cloward <heathercloward@gmail.com>

---------

Co-authored-by: Heather Cloward <heathercloward@gmail.com>
2023-07-12 10:30:05 +01:00
Andrew Tatomyr
e9fea72e6a chore: remove cdn option from build-docs (#1168) 2023-07-10 15:29:32 +02:00
redocly-bot
e43228e59e sync: Synced local 'docs/' with remote 'docs/cli/' 2023-07-08 14:18:44 +00:00
Andrew Tatomyr
0ce9cab59a docs: documentation for telemetry + contributing guide update (#1139)
Co-authored-by: Lorna Mitchell <lorna.mitchell@redocly.com>
Co-authored-by: Ihor Karpiuk <ihor.karpiuk@redocly.com>
2023-06-26 21:26:19 +03:00
redocly-bot
80a412178e sync: Synced local 'docs/' with remote 'docs/cli/' 2023-06-13 17:13:37 +00:00
Lorna Jane Mitchell
909fb471ca Add Vale for prose linting (#1099)
* feat: Add Vale configuration and rules

* docs: Fix top-level files to match Vale rules

* docs: Vale updates for the commands docs

* docs: apply Vale updates to the decorator docs

* docs: Update guides to match Vale rules

* docs: update rules and other content to meet Vale standards

* docs: add Vale link and information to CONTRIBUTING

* feat: Add GitHub action for Vale

* docs: minor editing to readme.md

* docs: minor editing to the changelog.md file

* docs: minor edits to the join.md file in commands folder

* docs: minor edits to lint.md file in the commands directory

* docs: minor edit to the login.md file in the commands directory

* docs: minor edits to the preview.md file in the commands directory

* docs: minor edits to push.md file in the comands directory

* docs: minor edits to the info-description-override.md file in the decorators directory

* docs: minor edits to the configure-rules.md file in the guides directory

* docs: minor edits to custom-plugin.md file in the resources directory

* docs: minor editing to the no-http-verbs-in-paths.md file in the rules directory

---------

Co-authored-by: Heather Cloward <heathercloward@gmail.com>
2023-06-01 10:10:43 +01:00
Andrew Tatomyr
04ff9e53d7 docs: update build-docs description (#1107)
Co-authored-by: Adam Altman <adam@redoc.ly>
2023-05-29 13:10:38 +02:00
Andrew Tatomyr
6729869869 docs: make greedy arrays false in yargs (#1084) 2023-05-25 16:28:29 +02:00
Lorna Jane Mitchell
3e461d5cc4 Add MLC for link checking (#1097)
* docs: add mlc config and github action to check links

Ignores relative links since we can only check those from the main
website project.

* docs: update redirecting links and configure some ignore patterns
2023-05-25 15:12:36 +01:00
Lorna Jane Mitchell
0455569a39 Docs: top-level refresh and restructure (#1043)
* docs: Start with a more developer and purpose oriented landing page

* docs: Clear installation options, autocomplete is a separate guide

* docs: update links in installation guide

* docs: Move update instructions to be a guide, remove local installation

* docs: Remove git documentation from starter project

* docs: Add a quicker quickstart

* docs: Re-organise and flesh out commands page

* docs: add built-in ruleset docs, add concept, start guide

* docs: Add a guide for configuring linting

* Docs: rename custom rules to assertions

* docs: Sort assertion docs and examples alphabetically

* docs: clearer linting explanations and signposting of rule types

* Apply suggestions from code review

Co-authored-by: Adam Altman <adam@redoc.ly>

* docs: Remove reference to a  config object, after user confusion

* docs: Add docs-building entrypoint article

* docs: Add one-line descriptions alongside rule names

* fix: Correct images for docs overview page

* docs: Link to custom function in custom plugin docs

* fix: Links in rules need updating after this file moved

* docs: Add concept article for openapi file wrangling

* docs: assertions are now called configurable rules

* fix: Broken links and a renamed file

* docs: Titles, links, and restructuring

* Apply suggestions from code review

Co-authored-by: Adam Altman <adam@redoc.ly>

* fix: Redirect for renamed CLI update guide

* Apply suggestions from code review

Co-authored-by: Adam Altman <adam@redoc.ly>

* chore: reduce filesize of images

* docs: Detangle the custom/configurable rules vs assertions confusion

* fix: labels as well as links to configurable rules

* Update docs/guides/configure-rules.md

Co-authored-by: Adam Altman <adam@redoc.ly>

* fix: Better example wording and fix title case

* Update docs/commands/index.md

Co-authored-by: Adam Altman <adam@redoc.ly>

* Update docs/rules/recommended.md

Co-authored-by: Adam Altman <adam@redoc.ly>

* Update docs/quickstart.md

Co-authored-by: Adam Altman <adam@redoc.ly>

* Update docs/rules.md

Co-authored-by: Adam Altman <adam@redoc.ly>

* chore: rename file built-in-rules.md and corresponding links (#1075)

---------

Co-authored-by: Adam Altman <adam@redoc.ly>
2023-05-10 17:40:59 +01:00
Ihor Karpiuk
ebbdc17488 chore: 1.0.0-beta.126 (#1069) 2023-05-10 13:06:29 +03:00
Ihor Karpiuk
0e17f3194f fix: do not execute decorators and preprocessors in join command (#1046) 2023-04-18 15:36:20 +03:00
Alex Varchuk
3714cf8871 docs: add docs for the build-docs command (#871) 2023-01-25 12:54:17 +02:00
Adam Altman
a2213bb5db docs: rename features.openapi and features.mockServer in config (#983) 2023-01-25 12:05:03 +02:00
Noah-Jerome Lotzer
3e6eb0f1e2 feat: join: add custom output file option (#987) 2023-01-12 15:10:08 +02:00
Adam Altman
9cad7e2e8d docs: rework assertions into custom rules (#917) 2022-11-02 06:58:54 -05:00
Ivan Osypov
bb8b9121c4 feat: ability to add other files and folders to push (#842)
* feat: ability to add other files and folders to push

* Remove console.log

* Prettier fix

* Merge args in loadConfig

* Update docs/commands/push.md

Co-authored-by: Andrew Tatomyr <andrew.tatomyr@redocly.com>

* Update packages/cli/src/commands/push.ts

Co-authored-by: Andrew Tatomyr <andrew.tatomyr@redocly.com>

* Make code cleaner

* add test for --files arg

* Support files in apos section

* Change nerge config logic

* get unique files

* fix test

* fix test

* fix test

Co-authored-by: Andrew Tatomyr <andrew.tatomyr@redocly.com>
2022-09-16 10:27:51 +03:00
Roman Hotsiy
9a47da57f3 feat: new format option 'summary' (#860) 2022-09-08 13:42:48 -05:00
Andrew Tatomyr
b325e6f503 chore: rename 'entrypoints' into 'apis' (#802) 2022-08-09 18:07:23 +02:00
Roman Hotsiy
c3ce34af84 docs: add missing --remove-unused-components (#774) 2022-07-26 06:48:24 -05:00
redocly-bot
417c28b6a8 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-07-18 22:16:28 +00:00
Yevhen Smoliy
b19808c2e3 chore: v1.0.0 beta.103 (#739)
* chore: v1.0.0-beta.103

* feat: add new decorators filter-in and filter-out (#736)

* feat: add new decorators filter-in and filter-out

* chore: remove unused parameters for filter tests

* chore: rename parameter and add new test

* chore: update changelog and build-in-decorators doc

* docs: update docs and changelog

Co-authored-by: Roman Hotsiy <gotsijroman@gmail.com>

Co-authored-by: Roman Hotsiy <gotsijroman@gmail.com>

Co-authored-by: Roman Hotsiy <gotsijroman@gmail.com>

Co-authored-by: Roman Hotsiy <gotsijroman@gmail.com>

Co-authored-by: Roman Hotsiy <gotsijroman@gmail.com>

Co-authored-by: Ihor Karpiuk <106662428+IgorKarpiuk@users.noreply.github.com>
Co-authored-by: igor <Ihor.karpiuk@redocly.com>
Co-authored-by: Roman Hotsiy <gotsijroman@gmail.com>
2022-06-27 16:54:24 +03:00
Anton Kozachuk
f9ab85e1ee fix: run-id parameter is not working properly (#735)
Co-authored-by: Anton Kozachuk <antonkozachuk@Antons-MacBook-Pro.local>
2022-06-22 18:50:23 +03:00
redocly-bot
83cc35b9f8 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-06-09 15:09:57 +00:00
redocly-bot
7952b21a8e sync: Synced local 'docs/' with remote 'docs/cli/' 2022-06-09 11:31:49 +00:00
redocly-bot
aae2c89031 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-06-09 11:31:09 +00:00