Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
76 lines (49 loc) · 3.53 KB

CONTRIBUTING.md

File metadata and controls

76 lines (49 loc) · 3.53 KB

English | 日本語

Thank you for your interest in contributing to Yamada UI😎, you are awesome!!!

When it comes to open source, there are different ways you can contribute, all of which are valuable. Here are some guidelines that should help you as you prepare your contribution.

Setup the Project

The following steps will get you up and running to contribute to Yamada UI:

  1. Fork the repository.

  2. Clone your fork locally.

git clone https://github.com/<your_github_username>/yamada-docs.git

cd yamada-docs

  1. Setup all the dependencies and packages by running pnpm install. This command will install dependencies.

  2. Run pnpm dev to start the local server.

Tip

In the case of Windows, contentlayer may not work as expected. If so, run npx contentlayer build before pnpm dev.

Commands

  • pnpm install: Sets up all dependencies and packages.
  • pnpm dev: Launches the local server.
  • pnpm build: Builds the site.
  • pnpm lint: Checks for code issues.

Update the Document

Commit Convention

Before you create a Pull Request, please check whether your commits comply with the commit conventions used in this repository.

When you create a commit we kindly ask you to follow the convention category(scope or module): message in your commit message while using one of the following categories:

  • feat / feature: all changes that introduce completely new code or new features
  • fix: changes that fix a bug (ideally you will additionally reference an issue if present)
  • refactor: any code related change that is not a fix nor a feature
  • docs: changing existing or creating new documentation (i.e. README, docs for usage of a lib or cli usage)
  • build: all changes regarding the build of the software, changes to dependencies or the addition of new dependencies
  • test: all changes regarding tests (adding new tests or changing existing ones)
  • ci: all changes regarding the configuration of continuous integration (i.e. github actions, ci system)
  • chore: all changes to the repository that do not fit into any of the above categories

Tip

If you are interested in the detailed specification you can visit Conventional Commits or check out the Angular Commit Message Guidelines.

Steps to PR

  1. Fork and clone the repository.

  2. Create a new branch from the main branch, following the [type/scope] naming convention. For example, fix/accordion-hook or menu-typo. Type is one of the standard commit types such as docs, fix, feat, build, etc. Scope is a short word that represents the scope of work.

  3. Make changes and commit according to the commit convention.

  4. Once all the tasks above are completed, push your changes. After pushing, a pull request URL will be generated. Please submit your request following the template. Also, check the checks within the pull request and make sure the build has completed successfully. If there are any issues, this pull request will not be merged.

License

By contributing code to the Yamada UI GitHub repository, you agree that your contributed code will be licensed under the MIT license.

Thank you for reading till the end. I love you too. 💖