Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: sync api from nextui-cli v0.2.1 #3079

Closed
wants to merge 1 commit into from
Closed

Conversation

winchesHe
Copy link
Member

@winchesHe winchesHe commented May 25, 2024

Sync api from nextui-cli.

Summary by CodeRabbit

  • Documentation
    • Updated CLI API documentation for improved clarity and detailed descriptions for commands:
      • -v, --version: Output the current version.
      • -h, --help: Display help information for commands.
      • init: Initializes a new project.
      • add: Adds components to your project.
      • upgrade: Upgrades project components to the latest versions.
      • remove: Removes components from the project.
      • list: Lists all components, showing status, descriptions, and versions.
      • env: Displays debugging information for the local environment.
      • doctor: Checks for issues in the project.
      • help [command]: Display help for command.

Copy link

vercel bot commented May 25, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
nextui-docs-v2 ✅ Ready (Inspect) Visit Preview 💬 Add feedback May 25, 2024 3:41pm
nextui-storybook-v2 ✅ Ready (Inspect) Visit Preview 💬 Add feedback May 25, 2024 3:41pm

Copy link

changeset-bot bot commented May 25, 2024

⚠️ No Changeset found

Latest commit: 95a9ce8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link
Contributor

coderabbitai bot commented May 25, 2024

Walkthrough

The recent updates primarily involve minor textual adjustments and clarifications in the documentation for the CLI API, enhancing the descriptions for various commands to provide more precise guidance. Additionally, there is an insignificant change in the routes.json file, specifically a modification related to the newline at the end of the file, without impacting any functionality.

Changes

Files Change Summary
apps/docs/config/routes.json Minor modification related to the newline at the end of the file, no significant functional changes.
apps/docs/content/docs/api-references/cli-api.mdx Updated descriptions of CLI commands for better clarity and precision.

Tip

New Features and Improvements

Review Settings

Introduced new personality profiles for code reviews. Users can now select between "Chill" and "Assertive" review tones to tailor feedback styles according to their preferences. The "Assertive" profile posts more comments and nitpicks the code more aggressively, while the "Chill" profile is more relaxed and posts fewer comments.

AST-based Instructions

CodeRabbit offers customizing reviews based on the Abstract Syntax Tree (AST) pattern matching. Read more about AST-based instructions in the documentation.

Community-driven AST-based Rules

We are kicking off a community-driven initiative to create and share AST-based rules. Users can now contribute their AST-based rules to detect security vulnerabilities, code smells, and anti-patterns. Please see the ast-grep-essentials repository for more information.

New Static Analysis Tools

We are continually expanding our support for static analysis tools. We have added support for biome, hadolint, and ast-grep. Update the settings in your .coderabbit.yaml file or head over to the settings page to enable or disable the tools you want to use.

Tone Settings

Users can now customize CodeRabbit to review code in the style of their favorite characters or personalities. Here are some of our favorite examples:

  • Mr. T: "You must talk like Mr. T in all your code reviews. I pity the fool who doesn't!"
  • Pirate: "Arr, matey! Ye must talk like a pirate in all yer code reviews. Yarrr!"
  • Snarky: "You must be snarky in all your code reviews. Snark, snark, snark!"

Revamped Settings Page

We have redesigned the settings page for a more intuitive layout, enabling users to find and adjust settings quickly. This change was long overdue; it not only improves the user experience but also allows our development team to add more settings in the future with ease. Going forward, the changes to .coderabbit.yaml will be reflected in the settings page, and vice versa.

Miscellaneous

  • Turn off free summarization: You can switch off free summarization of PRs opened by users not on a paid plan using the enable_free_tier setting.
  • Knowledge-base scope: You can now set the scope of the knowledge base to either the repository (local) or the organization (global) level using the knowledge_base setting. In addition, you can specify Jira project keys and Linear team keys to limit the knowledge base scope for those integrations.
  • High-level summary placement: You can now customize the location of the high-level summary in the PR description using the high_level_summary_placeholder setting (default @coderabbitai summary).
  • Revamped request changes workflow: You can now configure CodeRabbit to auto-approve or request changes on PRs based on the review feedback using the request_changes_workflow setting.

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share
Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai generate interesting stats about this repository and render them as a table.
    • @coderabbitai show all the console.log statements in this repository.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (invoked as PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai help to get help.

Additionally, you can add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.

CodeRabbit Configration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

Outside diff range and nitpick comments (1)
apps/docs/content/docs/api-references/cli-api.mdx (1)

Line range hint 116-116: There are typos where the word "file" is repeated. Consider removing the duplicate word for clarity.

- The path to the tailwind.config file file
+ The path to the tailwind.config file

Also applies to: 254-254, 349-349

Review Details

Configuration used: .coderabbit.yaml
Review profile: CHILL

Commits Files that changed from the base of the PR and between fa26ce0 and 95a9ce8.
Files selected for processing (2)
  • apps/docs/config/routes.json (1 hunks)
  • apps/docs/content/docs/api-references/cli-api.mdx (12 hunks)
Files skipped from review due to trivial changes (1)
  • apps/docs/config/routes.json
Additional Context Used
LanguageTool (8)
apps/docs/content/docs/api-references/cli-api.mdx (8)

Near line 104: It appears that a hyphen is missing (if ‘auto’ is not used in the context of ‘cars’).
Context: ...s to your project. #### Features > 1. Auto add the missing required dependencies to ...
Rule ID: AUTO_HYPHEN


Near line 116: Possible typo: you repeated a word
Context: ...string] The path to the tailwind.config file file - -app --appPath [string] The path to...
Rule ID: ENGLISH_WORD_REPEAT_RULE


Near line 118: The double modal “required installed” is nonstandard (only accepted in certain dialects). Consider “to be installed”.
Context: ...ormat in the add content which required installed prettier - (default: false) - `--addApp...
Rule ID: NEEDS_FIXED


Near line 254: Possible typo: you repeated a word
Context: ...string] The path to the tailwind.config file file - --prettier [boolean] Add prettier f...
Rule ID: ENGLISH_WORD_REPEAT_RULE


Near line 255: The double modal “required installed” is nonstandard (only accepted in certain dialects). Consider “to be installed”.
Context: ...ormat in the add content which required installed prettier - (default: false) ##### Exam...
Rule ID: NEEDS_FIXED


Near line 305: Possible missing preposition found.
Context: ...o the package.json file - -r --remote List all components available remotely ####...
Rule ID: AI_HYDRA_LEO_MISSING_TO


Near line 340: It seems that a pronoun is missing.
Context: ...[options] ``` ### Features > 1. Check whether have redundant dependencies in the pr...
Rule ID: IF_VB


Near line 349: Possible typo: you repeated a word
Context: ...string] The path to the tailwind.config file file - -app --appPath [string] The path ...
Rule ID: ENGLISH_WORD_REPEAT_RULE

Additional comments not posted (2)
apps/docs/content/docs/api-references/cli-api.mdx (2)

30-31: Updated descriptions for -v, --version and -h, --help options are clear and provide better information to the user.


34-41: The command descriptions have been updated to use more active and precise language, which improves clarity and consistency across the documentation.


Diagnose problems in your project.
### Features

> 1. Check whether have `redundant dependencies` in the project
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrase "Check whether have redundant dependencies" is missing a pronoun. Consider revising for grammatical correctness.

- Check whether have `redundant dependencies`
+ Check whether you have `redundant dependencies`

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
> 1. Check whether have `redundant dependencies` in the project
> 1. Check whether you have `redundant dependencies` in the project


```codeBlock bash
nextui list [options]
```

### Options
#### List Options

- `-p --packagePath` [string] The path to the package.json file
- `-r --remote` List all components available remotely
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems there might be a missing preposition in the phrase "List all components available remotely." Consider adding "that are" for better readability.

- List all components available remotely
+ List all components that are available remotely

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- `-r --remote` List all components available remotely
- `-r --remote` List all components that are available remotely


Add NextUI components to your project.

#### Features

> 1. Auto add the missing required `dependencies` to your project
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrase "Auto add" might be missing a hyphen. Consider changing it to "Auto-add" if it refers to an automatic process.

- Auto add the missing required `dependencies`
+ Auto-add the missing required `dependencies`

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
> 1. Auto add the missing required `dependencies` to your project
> 1. Auto-add the missing required `dependencies` to your project

@@ -112,7 +118,7 @@
- `--prettier` [boolean] Add prettier format in the add content which required installed prettier - (default: false)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrase "required installed" is nonstandard. Consider revising to "to be installed" for grammatical correctness.

- which required installed prettier
+ which requires prettier to be installed

Also applies to: 255-255


Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- `--prettier` [boolean] Add prettier format in the add content which required installed prettier - (default: false)
- `--prettier` [boolean] Add prettier format in the add content which requires prettier to be installed - (default: false)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant