8.0.0

Happy Halloween y'all! 🎃

We're shipping version 🎱 of rdme with lots of new features to improve the experience of syncing your docs to ReadMe and setting up your GitHub Actions workflow. Get the details on everything below!

What's Changed

Breaking Changes

• This release completely overhauls the prompts system. Prompts will now automatically error out if prompts are attempted from within a CI environment.
  • refactor: migrate from enquirer to prompts by @kanadgupta in #570
  • chore(prompt): various enhancements and refactors by @kanadgupta in #576
• If the --version option (used in the openapi command and the docs family of commands) is omitted in a CI environment, no version information will be sent in the request to the ReadMe API. This will typically result in the API defaulting to the default (i.e., stable) version.
  • feat(openapi): version handling improvements by @kanadgupta in #559
• The validate command has been renamed to openapi:validate. The validate command is now deprecated.
  • feat: migrate validate to openapi:validate by @kanadgupta in #598
• The versions command now returns raw JSON as the output and no longer returns a table format.
  • feat(breaking/version): raw versions only, usage cleanup by @kanadgupta in #603
• The versions:update command now accepts the version parameter as the default option (rather than via a --version flag) so the usage is consistent with versions:create and versions:delete
  • feat(breaking/version): raw versions only, usage cleanup by @kanadgupta in #603
• The changelogs:single, custompages:single, and docs:single commands have been removed in favor of their non-single counterparts (i.e., the changelogs, custompages, and docs commands), which have been simplified to support both single files and directories containing the files you wish to sync.

  • For example, if this was your command in v7:

    rdme changelogs:single file.md

    it will look like this in v8:

    rdme changelogs file.md

  • feat(docs): consolidate single commands by @kanadgupta in #642

• The docs:edit command has been deprecated and will be removed in an upcoming major release.
  • feat(breaking/docs): deprecate docs:edit by @kanadgupta in #646
• Simplified various non-versions prompts (e.g., openapi, categories) that previously asked if you wanted to create a new version or use an existing one.
  • Note: This change was marked as breaking but will not break any commands in CI. The only difference is that affected commands will have a slightly simplified prompt question flow.
  • feat(breaking): drop version creation question from prompt flows by @kanadgupta in #635

Other Highlights

• There is now a new onboarding experience to help you get set up with GitHub Actions. Head over to our blog to get the details!
  • feat(GHA): workflow file creation onboarding by @kanadgupta in #577
• rdme now includes a new openapi:reduce command which allows you to reduce a large API definition down to a specific set of tags or paths. This can be useful if you're debugging a problematic schema somewhere, or if you have a file that is too big to maintain.
  • feat: creation of new openapi:reduce command to reduce large OpenAPI definitions by @erunion in #572
• The login command no longer requires the --2fa flag for users with two-factor authentication enabled. The CLI will instead will prompt users for their 2FA code if their account necessitates it.
  • feat(breaking/login): remove 2fa flag in favor of better prompts by @kanadgupta in #619
• If a command requires authentication and the user forgets to pass in an API key via the --key option, the CLI will now prompt the user to log in.
  • feat: prompt for login any time a user omits API key by @kanadgupta in #636
• The openapi family of commands will now automatically detect your OpenAPI / Swagger definition. See Omitting the File Path in the command reference.
  • feat(openapi): auto-detect API definitions by @kanadgupta in #567
• The openapi:validate command will now return every error it finds with your API definition, not just the first one it finds.
  • fix(validate): surface all validation errors by @erunion in #639
• There is now a docs:prune command which will remove any docs from ReadMe that are not in your local directory (thanks @shaiarmis!)
  • feat(docs): adds ability to delete docs from ReadMe if they're no longer in local folder by @shaiarmis in #581
  • refactor(docs): move --cleanup option into docs:prune command by @kanadgupta in #644
  • feat(docs:prune): --confirm flag to bypass prompt by @shaiarmis in #648
• There is now a guides alias for the docs family of commands.
  • feat(docs): add guides alias by @kanadgupta in #647
• Our docs have been completely overhauled! New design, new guidance, and even more examples than before.
  • docs: v8 docs by @kanadgupta in #637

Other (Non-Breaking) Highlights

• feat(logger): add GHA-aware notices/warnings by @kanadgupta in #557
• feat(openapi): add --create flag by @kanadgupta in #575
• feat(openapi): add update option to automatically update an only available spec file without any prompts by @shaiarmis in #579
• feat(docs): Add id to success message response for docs and docs:single by @garrett-wade in #583
• feat(openapi): add --dryRun option by @darrenyong in #612
• feat(openapi): raw command output option by @kanadgupta in #613
• feat(baseCommand): inform user which project they're making changes to by @darrenyong in #643

Other Updates

This release includes various package updates to address security vulnerabilities, in addition to other behind-the-scenes updates.

• chore(deps-dev): bump jest from 28.1.2 to 28.1.3 by @dependabot in #552
• chore(deps-dev): bump nock from 13.2.8 to 13.2.9 by @dependabot in #554
• chore(deps-dev): bump @readme/oas-examples from 5.4.0 to 5.5.0 by @dependabot in #555
• refactor(openapi): DRY and logic reorg by @kanadgupta in #556
• feat: typescript rewrite by @erunion in #560
• feat: add prettier formatting check for markdown by @kanadgupta in #561
• refactor: consolidate auth checks by @kanadgupta in #562
• feat: minor refactor of how we debug and log out data in commands by @erunion in #563
• feat: upgrading oas-normalize to pull in its new TS typings by @erunion in #564
• ci: optimize test runs and add docs syncing dry run by @kanadgupta in #565
• fix: quieter log outputs when installing GHA by @kanadgupta in #566
• chore(deps-dev): bring in types for @npmcli/ci-detect by @kanadgupta in #569
• chore(deps): bump @actions/core from 1.9.0 to 1.9.1 by @dependabot in #571
• feat: experiment with a decorator to hide commands from the help s...

7.5.0

In v7.5, we finally ship support for several long-requested features—Changelog and Custom Pages! The functionality is nearly identical to that of the docs command—pass in a directory of Markdown (or in the case of Custom Pages, Markdown or HTML), and rdme will magically sync it to your ReadMe project. Get the details in our docs!

What's Changed

• refactor(docs): consolidate logic by @kanadgupta in #540
• refactor: split out fixtures, test cleanup by @kanadgupta in #542
• feat: changelog endpoints by @kanadgupta in #543
• refactor: rename category to cmdCategory in Command class by @kanadgupta in #544
• feat: add retag-release workflow to add a vX.Y.Z tag for our GitHub Action by @RyanGWU82 in #545
• feat: custom pages support by @kanadgupta in #547
• docs: guidance on custompages + changelog by @kanadgupta in #548

New Contributors

• @RyanGWU82 made their first contribution in #545

Full Changelog: 7.4.0...7.5.0

7.4.0

In this release, we add commands for Categories, as well as a docs:single command for syncing individual Markdown files. Thanks @garrett-wade!

What's Changed

• ci: run tests on pull_request event by @kanadgupta in #531
• chore(deps-dev): bump jest from 28.1.1 to 28.1.2 by @dependabot in #532
• chore(deps-dev): bump nock from 13.2.7 to 13.2.8 by @dependabot in #534
• feat: add docs:single by @garrett-wade in #529
• feat(config): add ability to override host + hub by @kanadgupta in #535
• fix(openapi): clearer copy, smol refactors by @kanadgupta in #536
• docs: add some language on --2fa option by @kanadgupta in #537
• feat: better error-handling for non-JSON responses by @kanadgupta in #538
• feat: add categories and categories:create by @garrett-wade in #530

New Contributors

• @garrett-wade made their first contribution in #529

Full Changelog: 7.3.0...7.4.0

7.3.0

What's Changed

• ci(CodeQL): add config by @kanadgupta in #521
• perf(openapi): upload improvements by @kanadgupta in #518
• chore(deps-dev): bump @readme/oas-examples from 5.3.0 to 5.4.0 by @dependabot in #524
• test(openapi/validate): cleanup 🧹 by @kanadgupta in #520
• chore(deps): bump @actions/core from 1.8.2 to 1.9.0 by @dependabot in #527

Full Changelog: 7.2.2...7.3.0

7.2.2

What's Changed

• feat: support .yml when auto-detecting OAS by @kanadgupta in #517

Full Changelog: 7.2.1...7.2.2

7.2.1

What's Changed

• chore(deps): bump github/codeql-action from 1 to 2 by @dependabot in #500
• chore(deps-dev): bump jest from 27.5.1 to 28.0.3 by @dependabot in #501
• chore(deps-dev): bump eslint from 8.13.0 to 8.14.0 by @dependabot in #502
• chore(deps): bump @actions/core from 1.6.0 to 1.7.0 by @dependabot in #503
• chore(deps-dev): bump @readme/eslint-config from 8.7.0 to 8.7.3 by @dependabot in #505
• chore(deps): bump command-line-usage from 6.1.1 to 6.1.3 by @dependabot in #504
• chore(deps-dev): bump @readme/oas-examples from 5.1.1 to 5.2.0 by @dependabot in #512
• chore(deps-dev): bump jest from 28.0.3 to 28.1.0 by @dependabot in #513
• chore(deps-dev): bump eslint from 8.14.0 to 8.16.0 by @dependabot in #511
• chore(deps-dev): bump @readme/eslint-config from 8.7.3 to 8.7.5 by @dependabot in #514
• chore(deps): bump @actions/core from 1.7.0 to 1.8.2 by @dependabot in #510
• Don't log API Key by @benwaffle in #516

Full Changelog: 7.2.0...7.2.1

7.2.0

What's Changed

• feat(help): typos, add rdme version by @kanadgupta in #493
• docs: embed loom video by @kanadgupta in #494
• feat: adding support for node 18 by @erunion in #495

Full Changelog: 7.1.1...7.2.0

7.1.1

What's Changed

• docs(docs): clarify slug handling by @kanadgupta in #491
• fix: unsupported version error message having double "v"s by @erunion in #492

Full Changelog: 7.1.0...7.1.1

7.1.0

What's Changed

• fix: messy issues with nodeVersionUtils helper needing semver installed by @erunion in #489
• feat: extending support to node 17 by @erunion in #490

Full Changelog: 7.0.3...7.1.0

7.0.3

What's Changed

• chore(deps): bump debug from 4.3.3 to 4.3.4 by @dependabot in #487
• feat: throwing error messaging on node 12 being unsupported by @erunion in #486
• fix: our broken set-version-output script by @erunion in #488

Full Changelog: 7.0.2...7.0.3