Commit Graph

20 Commits

Author SHA1 Message Date
Sasheeny Hubbard
76669ca2ab docs: fix redocly cli quickstart (#1585)
* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* Update quickstart.md

* docs: minor formatting and copyedit updates

* docs: Update final example and add closing links

* docs: fix a markdown issue

* docs: run prettier

---------

Co-authored-by: Lorna Mitchell <lorna.mitchell@redocly.com>
2024-07-24 10:37:48 +01: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
redocly-bot
9199b2bab7 sync: Synced local 'docs/' with remote 'docs/cli/' 2023-10-09 16:35:49 +00: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
Antonio
013e52e18c docs: make folder tree for split command in quick start more readable (#743) 2023-04-05 16:11:03 +01:00
redocly-bot
c9ce9968ee sync: Synced local 'docs/' with remote 'docs/cli/' 2023-03-31 17:40:35 +00:00
Adam Altman
9cad7e2e8d docs: rework assertions into custom rules (#917) 2022-11-02 06:58:54 -05:00
redocly-bot
296ffe5637 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-08-01 23:30:33 +00:00
Jody Winter
1b889ca869 docs: fix typo in cli quickstart (#704) 2022-05-25 19:33:52 -05:00
redocly-bot
4d8cf1f186 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-05-14 18:42:52 +00:00
Roman Hotsiy
1cacff2044 chore: rename package to @redocly/cli (#672)
Co-authored-by: Andrew Tatomyr <andrew.tatomyr@gmail.com>
Co-authored-by: Ivana Isadora Devcic <skadinna@gmail.com>
2022-05-06 16:12:56 +02:00
redocly-bot
73048f7034 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-05-05 01:02:23 +00:00
Jody Winter
856174638b Update quickstart.md (#577)
* Update quickstart.md

I used Open Weather Map’s Current Weather Data API for testing as I know we need to stop using petstore. This is the API that is used throughout Tom Johnson’s API docs course. I tested all commands and everything worked fine.

* Update docs/quickstart.md

Co-authored-by: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>

* Update quickstart.md

Second draft, post-reviews.

* fix: minor text formatting and phrasing changes

* Update docs/quickstart.md

Co-authored-by: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>

* Update docs/quickstart.md

Co-authored-by: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>

* Update docs/quickstart.md

Co-authored-by: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>

* Update quickstart.md

Updated based on review feedback.

* Respond to suggested change

* fix: internal links

Co-authored-by: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>
Co-authored-by: Swapnil Ogale <swapnilogale@gmail.com>
2022-03-28 23:48:16 +02:00
redocly-bot
d622c06d5c sync: Synced local 'docs/' with remote 'docs/cli/' 2022-03-24 12:46:26 +00:00
redocly-bot
5b9cc9d714 sync: Synced local 'docs/' with remote 'docs/cli/' 2022-02-10 17:33:10 +00:00
redocly-bot
4ff120daba sync: Synced local 'docs/' with remote 'docs/cli/' 2021-08-30 21:24:14 +00:00
redocly-bot
6f23fb4393 sync: Synced local 'docs/' with remote 'docs/cli/' 2021-08-25 21:19:04 +00:00
Antonio
9259798cd7 docs: added the first version of the quickstart guide for openapi-cli (#342) 2021-08-25 14:46:03 -05:00