Contributing

This guide explains our contribution guidelines and how you can contribute to the All Contributor projects. There are many ways to contribute, from ideas over coding to

Help improve the All Contributors documentation!

Latest Release: v2.17.1 Stars: 8,084

프로젝트에 관심을 가져 주셔서 감사합니다! Pull Requests are welcome for any type of improvement, from a small typo to a new section in the docs. Help us make the project better!

All of the source code for the documentation is available in this repository. The All Contributors bot lives in the app repository. And the All Contributors CLI lives in the cli repository.

How to commit

We use the angular commit convention for commits that are used for an automated changelog generation, so it would be advisable to respect that. If you’re not used to it or are afraid to mistype a commit, you can run npm run commit or git cz (if you have installed commitizen) which would take you through a few questions and write the commit for you.

콘텐츠 편집

Once on a file, click the ‘pencil’ icon to easily edit the file inline. After making your changes, create a commit with your changes. You will want to create and commit these changes on a new branch in your fork of the repository.

After committing your changes, you can create a pull request to propose your changes to be merged into the main branch.

A screenshot that shows the GitHub interface with a file open focused on the pencil icon that allows you to edit the page.

번역

번역은 crowdin를 통해 관리 됩니다. You can help contribute by heading to the crowdin project and suggesting translations. If you like, comment on this issue to let us know you’re helping or if you have any queries!

When translating, anything that has the XPATH @href, @src etc mustn’t be translated. Things like code should not be either. 번역시에 404 페이지로 이동합니다. 아래 이미지를 참조하세요.

A screenshot that shows the GitHub interface with a file open focused on the pencil icon that allows you to edit the page.

However, it’s recommended to translate any content that would contribute to a better comprehension like the comments in code tags as long as it doesn’t change the actual code since it only understands English.

참여 방법

Crowdin에 로그인

Go to the crowdin project, then sign up and/or log in.
그리고 나서 “All Contributors” 프로젝트에 참여하세요!

문자 번역

Go to the crowdin project.
번역 할 언어의 국기를 클릭하십시오.
Click on any *.md files that aren’t completely translated (read showing 100% on the right-hand side)
Write your translation in the “Enter translation here” field (which would correspond to the translation of the text in the “SOURCE STRING” field above) then click “SAVE”
For proofreaders only: You can either approve translation suggestions (whether it’s done by you or someone else), which you will find in the “[LANGUAGE] TRANSLATIONS” section, by clicking on the :ballot_box_with_check: or delete them by clicking on the :wastebasket: icon.

배포 변경

After you translate strings in any given language, you won’t see those changes appearing live until the main branch was updated followed by a successful deployment.

Run the website locally

All Contributors currently uses Astro with Starlight for our documentation and website.

To build the docs locally:

Make sure npm is installed on your machine. Use the nodejs documentation if you aren’t sure how to install npm.

To check that npm is installed run the following in your favorite shell:
Terminal window
```
npm -v
```
Next, make sure you have at least node version 0.22 (LTS) or higher. To check the version, use:
Terminal window
```
node -v
```
If you don’t have atleast version .22 or higher, please install node or upgrade your current version.
Install all dependencies:
- npm
- pnpm
- Yarn
Terminal window
npm i
Terminal window
pnpm i
Terminal window
yarn i
Once you have completed the above, you can launch a server locally that will build and run the docs locally. In your favorite shell run:
- npm
- pnpm
- Yarn
Terminal window
npm run start
Terminal window
pnpm start
Terminal window
yarn start
Then, go to http://localhost:4321 and you will see the all contributors website there!

Refresh the browser page as needed when editing markdown pages.

Linting and formatting your contribution

If you make changes to a markdown file in the site, then our linting action will check those changes. To run the linter yourself locally on the documentation before submitting a PR use:

Lint: Scans for code smells and best-practice violations.
Terminal window
```
npm run lint
```
Lint & Fix: Scans and automatically applies safe fixes to your code.
Terminal window
```
npm run lint-fix
```

Lint: Scans for code smells and best-practice violations.
Terminal window
```
pnpm lint
```
Lint & Fix: Scans and automatically applies safe fixes to your code.
Terminal window
```
pnpm lint-fix
```

Lint: Scans for code smells and best-practice violations.
Terminal window
```
yarn lint
```
Lint & Fix: Scans and automatically applies safe fixes to your code.
Terminal window
```
yarn lint-fix
```

Checking links

We use Lychee to validate all links within the repository. This ensures that we don’t include any links that lead to broken pages.

If you want to run the link-check locally, run the following command:

npm run link-check

pnpm link-check

yarn link-check

If your changes introduced any broken links, Lychee will tell you which links you have to fix in the output.

기여자로 자신을 추가하기

To add yourself to the table of contributors, follow the bot usage instructions.