>**NOTE:** _This file has been translated automatically. If you find an error, just make a PR with the edits" to all translation files._
![ਚੰਗੇ ਪਹਿਲੇ ਮੁੱਦੇ](../assets/github/social-preview.png)

# ਚੰਗੇ ਪਹਿਲੇ ਮੁੱਦੇ

**ਗੁਡ ਫਸਟ ਇਸ਼ੂਜ਼** ਪ੍ਰਸਿੱਧ ਪ੍ਰੋਜੈਕਟਾਂ ਤੋਂ ਆਸਾਨੀ ਨਾਲ ਚੋਣ ਕਰਨ ਲਈ ਇੱਕ ਪਹਿਲਕਦਮੀ ਹੈ, ਇਸਲਈ ਡਿਵੈਲਪਰ ਜਿਨ੍ਹਾਂ ਨੇ ਕਦੇ ਵੀ ਓਪਨ-ਸੋਰਸ ਵਿੱਚ ਯੋਗਦਾਨ ਨਹੀਂ ਪਾਇਆ ਹੈ, ਜਲਦੀ ਸ਼ੁਰੂ ਕਰ ਸਕਦੇ ਹਨ।

ਵੈੱਬਸਾਈਟ: [good-first-issues.github.io](https://good-first-issues.github.io)

ਇਹ ਵੈੱਬਸਾਈਟ ਮੁੱਖ ਤੌਰ 'ਤੇ ਡਿਵੈਲਪਰਾਂ 'ਤੇ ਨਿਸ਼ਾਨਾ ਹੈ ਜੋ ਓਪਨ ਸੋਰਸ ਸੌਫਟਵੇਅਰ ਵਿੱਚ ਯੋਗਦਾਨ ਪਾਉਣਾ ਚਾਹੁੰਦੇ ਹਨ ਪਰ ਇਹ ਨਹੀਂ ਜਾਣਦੇ ਕਿ ਕਿੱਥੇ ਜਾਂ ਕਿਵੇਂ ਸ਼ੁਰੂ ਕਰਨਾ ਹੈ।

ਓਪਨ-ਸੋਰਸ ਮੇਨਟੇਨਰ ਹਮੇਸ਼ਾ ਜ਼ਿਆਦਾ ਲੋਕਾਂ ਨੂੰ ਸ਼ਾਮਲ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਨ, ਪਰ ਨਵੇਂ ਡਿਵੈਲਪਰ ਆਮ ਤੌਰ 'ਤੇ ਸੋਚਦੇ ਹਨ ਕਿ ਇਹ ਯੋਗਦਾਨ ਪਾਉਣਾ ਚੁਣੌਤੀਪੂਰਨ ਹੈ। ਸਾਡਾ ਮੰਨਣਾ ਹੈ ਕਿ ਡਿਵੈਲਪਰਾਂ ਨੂੰ ਅਤਿ-ਆਸਾਨ ਮੁੱਦਿਆਂ ਨੂੰ ਹੱਲ ਕਰਨ ਲਈ ਪ੍ਰਾਪਤ ਕਰਨਾ ਭਵਿੱਖ ਦੇ ਯੋਗਦਾਨਾਂ ਲਈ ਰੁਕਾਵਟ ਨੂੰ ਦੂਰ ਕਰਦਾ ਹੈ। ਇਸ ਲਈ *ਚੰਗੇ ਪਹਿਲੇ ਮੁੱਦੇ* ਮੌਜੂਦ ਹਨ।

## ਇੱਕ ਨਵਾਂ ਪ੍ਰੋਜੈਕਟ ਸ਼ਾਮਲ ਕੀਤਾ ਜਾ ਰਿਹਾ ਹੈ

*ਗੁੱਡ ਫਸਟ ਇਸ਼ੂਜ਼* ਵਿੱਚ ਇੱਕ ਨਵਾਂ ਪ੍ਰੋਜੈਕਟ ਸ਼ਾਮਲ ਕਰਨ ਲਈ ਤੁਹਾਡਾ ਸੁਆਗਤ ਹੈ, ਬੱਸ ਇਹਨਾਂ ਪੜਾਵਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ:

- *ਚੰਗੇ ਪਹਿਲੇ ਮੁੱਦੇ* ਵਿੱਚ ਪ੍ਰੋਜੈਕਟਾਂ ਦੀ ਗੁਣਵੱਤਾ ਨੂੰ ਬਣਾਈ ਰੱਖਣ ਲਈ, ਕਿਰਪਾ ਕਰਕੇ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਤੁਹਾਡੀ GitHub ਰਿਪੋਜ਼ਟਰੀ ਹੇਠਾਂ ਦਿੱਤੇ ਮਾਪਦੰਡਾਂ ਨੂੰ ਪੂਰਾ ਕਰਦੀ ਹੈ:

     - ਇਸ ਵਿੱਚ 'ਚੰਗਾ ਪਹਿਲਾ ਅੰਕ' ਲੇਬਲ ਨਾਲ ਘੱਟੋ-ਘੱਟ ਤਿੰਨ ਮੁੱਦੇ ਹਨ। ਇਹ ਲੇਬਲ ਪਹਿਲਾਂ ਹੀ ਸਭ ਰਿਪੋਜ਼ਟਰੀਆਂ ਉੱਤੇ ਮੂਲ ਰੂਪ ਵਿੱਚ ਮੌਜੂਦ ਹੈ।

     - ਇਸ ਵਿੱਚ ਪ੍ਰੋਜੈਕਟ ਲਈ ਵਿਸਤ੍ਰਿਤ ਸੈੱਟਅੱਪ ਨਿਰਦੇਸ਼ਾਂ ਦੇ ਨਾਲ ਇੱਕ `README.md` ਹੈ

     - ਇਹ ਸਰਗਰਮੀ ਨਾਲ ਬਣਾਈ ਰੱਖਿਆ ਗਿਆ ਹੈ (ਆਖਰੀ ਅਪਡੇਟ 1 ਮਹੀਨੇ ਤੋਂ ਘੱਟ ਪਹਿਲਾਂ)

- [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json) ਵਿੱਚ ਆਪਣੇ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਮਾਰਗ (ਫਾਰਮੈਟ `ਮਾਲਕ/ਨਾਮ` ਅਤੇ ਕੋਸ਼ਿਕ ਕ੍ਰਮ ਵਿੱਚ) ਸ਼ਾਮਲ ਕਰੋ।

- ਇੱਕ ਨਵੀਂ ਪੁੱਲ-ਬੇਨਤੀ ਬਣਾਓ। ਕਿਰਪਾ ਕਰਕੇ PR ਵਰਣਨ ਵਿੱਚ ਰਿਪੋਜ਼ਟਰੀ ਦੇ ਮੁੱਦੇ ਪੰਨੇ ਦਾ ਲਿੰਕ ਸ਼ਾਮਲ ਕਰੋ। ਪੁੱਲ ਬੇਨਤੀ ਦੇ ਵਿਲੀਨ ਹੋਣ ਤੋਂ ਬਾਅਦ, ਤਬਦੀਲੀਆਂ [good-first-issues.github.io](https://good-first-issues.github.io) 'ਤੇ ਲਾਈਵ ਹੋ ਜਾਣਗੀਆਂ।

## ਇਹ ਕਿਵੇਂ ਚਲਦਾ ਹੈ?

- ਪਹਿਲੀ *ਗੁੱਡ ਫਸਟ ਇਸ਼ੂਜ਼* ਇੱਕ ਸਥਿਰ ਵੈੱਬਸਾਈਟ ਹੈ ਜੋ HTML ਫਾਈਲਾਂ ਬਣਾਉਣ ਲਈ [PHP](https://www.php.net)` ਦੀ ਵਰਤੋਂ ਕਰਦੀ ਹੈ।
- ਅਸੀਂ [repositories.json](https://github.com/gomzyakov/good-first) ਵਿੱਚ ਸੂਚੀਬੱਧ ਰਿਪੋਜ਼ਟਰੀਆਂ ਤੋਂ ਸਮੱਸਿਆਵਾਂ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ [GitHub REST API](https://docs.github.com/en/rest) ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਾਂ -issue/blob/main/repositories.json)।
- ਸਮੇਂ-ਸਮੇਂ 'ਤੇ ਮੁੱਦਿਆਂ 'ਤੇ ਚੱਕਰ ਲਗਾਉਣ ਲਈ (ਦਿਨ ਵਿੱਚ ਦੋ ਵਾਰ), ਅਸੀਂ [GitHub Workflow](https://docs.github.com/en/actions/using-workflows) ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਾਂ।

## ਵਧਣ ਵਿੱਚ ਸਾਡੀ ਮਦਦ ਕਰੋ

ਓਪਨ-ਸਰੋਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨੂੰ ਨੈਵੀਗੇਟ ਕਰਨਾ ਸ਼ੁਰੂਆਤ ਕਰਨ ਵਾਲਿਆਂ ਅਤੇ ਤਜਰਬੇਕਾਰ ਯੋਗਦਾਨ ਪਾਉਣ ਵਾਲਿਆਂ ਲਈ ਬਹੁਤ ਜ਼ਿਆਦਾ ਭਾਰੀ ਹੋ ਸਕਦਾ ਹੈ। *ਚੰਗੇ ਪਹਿਲੇ ਮੁੱਦੇ* ਇੱਕ ਪਲੇਟਫਾਰਮ ਪ੍ਰਦਾਨ ਕਰਕੇ ਇਸ ਸਮੱਸਿਆ ਨੂੰ ਹੱਲ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਨ ਜੋ ਓਪਨ-ਸਰੋਤ ਨਾਲ ਸ਼ੁਰੂਆਤ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰਨ ਵਾਲਿਆਂ ਲਈ ਇੱਕ ਸ਼ੁਰੂਆਤੀ ਬਿੰਦੂ ਵਜੋਂ ਕੰਮ ਕਰਦਾ ਹੈ ਜਾਂ ਉਹਨਾਂ ਲਈ ਜੋ ਇੱਕ ਨਵੇਂ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਜਾਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਹੇ ਹਨ।

ਜਿੰਨੇ ਜ਼ਿਆਦਾ ਲੋਕ [good-first-issues.github.io](https://good-first-issues.github.io) ਬਾਰੇ ਜਾਣਦੇ ਹਨ, ਓਨਾ ਹੀ ਬਿਹਤਰ ਹੈ। ਇੱਥੇ ਵੱਖ-ਵੱਖ ਤਰੀਕੇ ਹਨ ਜਿਨ੍ਹਾਂ ਨਾਲ ਤੁਸੀਂ ਸਾਨੂੰ ਵਧਣ ਵਿੱਚ ਮਦਦ ਕਰ ਸਕਦੇ ਹੋ: ਤੁਸੀਂ 'ਸ਼ਾਨਦਾਰ' ਸੂਚੀਆਂ ਵਿੱਚ ਯੋਗਦਾਨ ਪਾ ਸਕਦੇ ਹੋ, ਸਾਡੇ ਬਾਰੇ ਬਲੌਗ, ਬਲੌਗਰਾਂ, ਤਕਨੀਕੀ ਪ੍ਰਭਾਵਾਂ, ਵਿਕਾਸਕਾਰ ਅਤੇ ਟਵਿੱਟਰ ਅਤੇ YouTube 'ਤੇ ਓਪਨ-ਸੋਰਸ ਤੱਕ ਪਹੁੰਚ ਕਰ ਸਕਦੇ ਹੋ, ਉਦਾਹਰਨ ਲਈ। ਕੋਸ਼ਿਸ਼ ਕਰੋ ਅਤੇ ਇੱਕ ਵੀਡੀਓ ਜਾਂ ਟਵੀਟ ਵਿੱਚ ਜ਼ਿਕਰ ਕੀਤੇ [good-first-issues.github.io](https://good-first-issues.github.io) ਪ੍ਰਾਪਤ ਕਰੋ!

## ਸੁਝਾਅ ਅਤੇ ਇੱਛਾਵਾਂ

ਜੇਕਰ ਤੁਹਾਡੇ ਕੋਈ ਸਵਾਲ ਜਾਂ ਸੁਝਾਅ ਹਨ (ਜਾਂ ਕੋਈ ਬੱਗ ਮਿਲਿਆ ਹੈ), ਤਾਂ ਤੁਸੀਂ ਹਮੇਸ਼ਾ [issues](https://github.com/good-first-issues/good-first-issues.github.io/issues) 'ਤੇ ਲਿਖ ਸਕਦੇ ਹੋ।

## ਲਾਇਸੰਸ

ਇਹ [MIT ਲਾਇਸੈਂਸ](https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE) ਦੇ ਅਧੀਨ ਲਾਇਸੰਸਸ਼ੁਦਾ ਓਪਨ-ਸੋਰਸਡ ਸੌਫਟਵੇਅਰ ਹੈ।
