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(documentation-website):Add npm run local to Contributor Guidelines #737

Merged
merged 7 commits into from
Apr 10, 2024

Conversation

akhil0203
Copy link
Contributor

The Pull Request is ready

Overview

This pull request addresses the issue by updating the contributor guidelines to include instructions for running Continuous Integration (CI) tasks locally using the npm run local command.

Documentation-Website

  • mobile view is usable
  • desktop view is usable
  • no a-tags are used directly (NavLink, MailLink, ExternalLink instead)
  • all new texts are added to the translation files (at least the english one)
  • tests have been added (if required)
  • shared code has been extracted in a different file

Copy link
Contributor

coderabbitai bot commented Apr 8, 2024

Walkthrough

Walkthrough

The integration has progressed with the addition of npm run local to our guidelines, enhancing our development process. This new directive empowers the collective to validate CI tasks locally before assimilation, fostering efficiency and compatibility within the codebase.

Changes

Files Changed Summary of Changes
CONTRIBUTING.md Added instructions for npm run local to run CI tasks locally

Assessment against linked issues

Objective Addressed Explanation
Add npm run local to contributor guidelines

Poem

As code flows like a river,
Through the veins of our collective,
npm run local now delivered,
A tool for inspection, quite effective.
Together, we enhance,
In unity, we advance.
🚀🐇

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:

Note: Auto-reply has been disabled for this repository by the repository owner. The CodeRabbit bot will not respond to your replies unless it is explicitly tagged.

  • 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.

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Apr 8, 2024
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Thank you for contributing!
Please make sure the actions pass. Once your pull request has been merged, you will automatically be added to the contributor's list on the website.
If you want to be shouted out on Linkedin, have a look for the shoutout issue of the specific version.

You can also find us on slack at idrinth-api-bench.

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: 1

Review Status

Configuration used: .coderabbit.yaml

Commits Files that changed from the base of the PR and between 87b23fc and 585ded4.
Files selected for processing (1)
  • CONTRIBUTING.md (1 hunks)
Additional Context Used
GitHub Check Runs (1)
Codacy Static Code Analysis action_required (1)

CONTRIBUTING.md: [notice] 118-118: CONTRIBUTING.md#L118
Expected: 80; Actual: 227

Additional comments not posted (1)
CONTRIBUTING.md (1)

116-124: Ensure clarity in instructions for running tests locally.

CodeRabbit suggests adding a brief explanation on how npm run local works and what CI tasks it covers. This will provide contributors with a better understanding of what to expect when they run this command.

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: 1

Review Status

Configuration used: .coderabbit.yaml

Commits Files that changed from the base of the PR and between 585ded4 and f69f3cd.
Files selected for processing (1)
  • CONTRIBUTING.md (1 hunks)
Additional Context Used
GitHub Check Runs (1)
Codacy Static Code Analysis action_required (1)

CONTRIBUTING.md: [notice] 119-119: CONTRIBUTING.md#L119
Expected: 80; Actual: 227

Additional comments not posted (1)
CONTRIBUTING.md (1)

117-125: Instructions for running tests locally are clear and fulfill the PR objectives.

CONTRIBUTING.md Outdated
@@ -114,6 +114,16 @@
npm run coai
```

#### Running Tests Locally

To see a list of available CI tasks and their corresponding commands to run them locally you can run `npm run local` in the source folder.This is particularly useful for testing specific CI tasks before committing your changes.
Copy link
Contributor

Choose a reason for hiding this comment

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

Add a space after the period for better readability.

- folder.This is particularly
+ folder. This is particularly

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
To see a list of available CI tasks and their corresponding commands to run them locally you can run `npm run local` in the source folder.This is particularly useful for testing specific CI tasks before committing your changes.
To see a list of available CI tasks and their corresponding commands to run them locally you can run `npm run local` in the source folder. This is particularly useful for testing specific CI tasks before committing your changes.

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: 1

Review Status

Configuration used: .coderabbit.yaml

Commits Files that changed from the base of the PR and between f69f3cd and e38fc75.
Files selected for processing (1)
  • CONTRIBUTING.md (1 hunks)

CONTRIBUTING.md Outdated Show resolved Hide resolved
@Idrinth
Copy link
Member

Idrinth commented Apr 8, 2024

@akhil0203 thank you for helping! Do you want to add the website changes as well? If not I'll merge the doc changes.

Files:
/documentation-website/language/en.yml
/documentation-website/src/pages/contributing/index.tsx

CONTRIBUTING.md Outdated
@@ -114,6 +114,16 @@ cd api-bench
npm run coai
```

#### Running Tests Locally

To see a list of available CI tasks and their corresponding commands to run them locally, you can run `npm run local` in the source folder. This is particularly useful for testing specific CI tasks before committing your changes.
Copy link
Member

Choose a reason for hiding this comment

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

we usually add a line break after 80 characters to make it unnecessary to scroll

CONTRIBUTING.md Outdated
```bash
git clone https://github.com/idrinth/api-bench
cd api-bench
npm run local
Copy link
Member

Choose a reason for hiding this comment

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

I doubt anyone would clone the repo just to get a list of tests, please remove the code here

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: 1

Review Status

Configuration used: .coderabbit.yaml

Commits Files that changed from the base of the PR and between e38fc75 and fe8da1f.
Files selected for processing (1)
  • CONTRIBUTING.md (1 hunks)
Additional comments not posted (1)
CONTRIBUTING.md (1)

117-121: Ensure line breaks after 80 characters to avoid the necessity to scroll.

CONTRIBUTING.md Outdated Show resolved Hide resolved
docs(documentation-website):Add npm run local to Contributor Guidelines
Copy link

sonarqubecloud bot commented Apr 8, 2024

Quality Gate Passed Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarCloud

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: 0

Review Status

Configuration used: .coderabbit.yaml

Commits Files that changed from the base of the PR and between fe8da1f and f38a198.
Files selected for processing (1)
  • CONTRIBUTING.md (1 hunks)
Additional comments not posted (1)
CONTRIBUTING.md (1)

117-121: Ensure readability improvements are incorporated.

@akhil0203
Copy link
Contributor Author

@akhil0203 thank you for helping! Do you want to add the website changes as well? If not I'll merge the doc changes.

Files: /documentation-website/language/en.yml /documentation-website/src/pages/contributing/index.tsx

i would love to do it ,as this is my first contribution to this awesome project i may take some time to sort it out but i will complete the task

@Idrinth
Copy link
Member

Idrinth commented Apr 8, 2024

@akhil0203 thank you for helping! Do you want to add the website changes as well? If not I'll merge the doc changes.
Files: /documentation-website/language/en.yml /documentation-website/src/pages/contributing/index.tsx

i would love to do it ,as this is my first contribution to this awesome project i may take some time to sort it out but i will complete the task

thanks, if you need any help, just ask - you can find at least me on our slack :) There is a guide to the language files on our youtube, that may actually help a bit: https://www.youtube.com/watch?v=FEYIeMCrrbk

@Idrinth
Copy link
Member

Idrinth commented Apr 10, 2024

@akhil0203 will merge the current change already, so we have you among the contributors already :) not taking the task away from you, just create a fresh branch for it please!

@Idrinth Idrinth merged commit ae12eb6 into idrinth-api-bench:master Apr 10, 2024
7 checks passed
@github-actions github-actions bot added this to the 2.8.0 milestone Apr 10, 2024
@Idrinth Idrinth modified the milestones: URGENT, Up for grabs May 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add npm run local to contributor guidelines
2 participants