ਮੈਂ ਇੱਕ PR ਮਰਜ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਦੋ ਵਾਰ ਕਿਵੇਂ ਰੱਦ ਹੋਇਆ

ਮੈਂ Awesome Second Brain ਵਿੱਚ ਯੋਗਦਾਨ ਪਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕੀਤੀ। Awesome Second Brain AI ਮੈਮੋਰੀ ਅਤੇ ਗਿਆਨ ਪ੍ਰਣਾਲੀਆਂ ਲਈ ਇੱਕ ਓਪਨ-ਸੋਰਸ ਸਰੋਤ ਹੈ। ਇਸਦੇ 200 ਤੋਂ ਵੱਧ ਸਟਾਰਸ ਹਨ ਅਤੇ ਨਿਯਮ ਬਹੁਤ ਸਖ਼ਤ ਹਨ। ਮੈਂ ਇੱਕ ਗੁੰਝਲਦਾਰ ਸਟੈਕ ਸਬਮਿਟ ਕੀਤਾ: Hermes Agent, Obsidian, ਅਤੇ Honcho।

ਮੈਂ ਦੋ ਵਾਰ ਅਸਫਲ ਰਿਹਾ। ਮੇਰੀ ਪੁੱਲ ਰਿਕਵੈਸਟ (pull request) ਨੂੰ ਮਰਜ ਕਰਨ ਲਈ ਤਿੰਨ ਵਾਰ ਸੁਧਾਰ ਕਰਨੇ ਪਏ। ਇੱਥੇ ਉਹ ਹੈ ਜੋ ਮੈਂ ਗਲਤ ਕੀਤਾ ਅਤੇ ਜੋ ਮੈਂ ਸਿੱਖਿਆ।

੧. ਮੈਂ ਡਾਕੂਮੈਂਟੇਸ਼ਨ ਦੀ ਬਜਾਏ ਯਾਦਦਾਸ਼ਤ 'ਤੇ ਭਰੋਸਾ ਕੀਤਾ ਮੈਂ ਉਹਨਾਂ ਕਮਾਂਡਾਂ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਇੱਕ ਸੈੱਟਅੱਪ ਗਾਈਡ ਲਿਖੀ ਜੋ ਮੈਨੂੰ ਲੱਗਿਆ ਕਿ ਮੌਜੂਦ ਹਨ। ਮੈਂ ਮੰਨ ਲਿਆ ਕਿ ਇੱਕ ਕੌਂਫਿਗ ਫਾਈਲ ਇੱਕ ਖਾਸ ਫੋਲਡਰ ਵਿੱਚ ਹੈ। ਮੈਂ ਮੰਨ ਲਿਆ ਕਿ ਇੱਕ CLI ਸਕ੍ਰਿਪਟ ਉਪਲਬਧ ਸੀ। ਮੈਂ ਗਲਤ ਸੀ। ਦੋਵੇਂ ਮੌਜੂਦ ਨਹੀਂ ਸਨ।

ਸਬਕ: ਕਦੇ ਵੀ ਯਾਦਦਾਸ਼ਤ ਤੋਂ ਕੋਈ ਕਮਾਂਡ ਨਾ ਲਿਖੋ। ਅਧਿਕਾਰਤ ਡਾਕੂਮੈਂਟਸ ਖੋਲ੍ਹੋ। ਸਹੀ ਪੰਨਾ ਲੱਭੋ। ਸਹੀ ਕਮਾਂਡ ਕਾਪੀ ਕਰੋ। ਜੇਕਰ ਤੁਹਾਨੂੰ ਇਹ ਨਹੀਂ ਮਿਲਦੀ, ਤਾਂ ਇਸਨੂੰ ਸ਼ਾਮਲ ਨਾ ਕਰੋ।

੨. ਮੇਰੇ ਕੋਲ ਗਲਤ ਮੈਟਾਡਾਟਾ ਸੀ ਮੈਂ ਕੰਪਨੀਆਂ ਦੇ ਨਾਮ ਮਿਲਾ ਦਿੱਤੇ। ਮੈਨੂੰ ਲੱਗਿਆ ਕਿ Plastic Labs ਨੇ Obsidian ਬਣਾਇਆ ਹੈ। ਉਹਨਾਂ ਨੇ ਨਹੀਂ। ਮੈਂ ਦਾਅਵਾ ਕੀਤਾ ਕਿ ਪੂਰਾ ਸਟੈਕ ਓਪਨ ਸੋਰਸ ਸੀ। ਇਹ ਨਹੀਂ ਹੈ। Obsidian ਅਤੇ AgentMail ਪ੍ਰੋਪਰਾਈਟਰੀ (proprietary) ਹਨ।

ਸਬਕ: ਹਰ ਵੇਰਵੇ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ। ਮੇਨਟੇਨਰ, ਲਾਇਸੈਂਸ ਅਤੇ ਰੈਪੋ (repo) ਦੀ ਸਥਿਤੀ ਦੀ ਜਾਂਚ ਕਰੋ। ਅੰਦਾਜ਼ਾ ਨਾ ਲਗਾਓ।

੩. ਮੈਂ ਬਿਨਾਂ ਸਬੂਤ ਦੇ ਵੱਡੇ ਦਾਅਵੇ ਕੀਤੇ ਮੈਂ ਦਾਅਵਾ ਕੀਤਾ ਕਿ ਸਟੈਕ "ਪੂਰੀ ਤਰ੍ਹਾਂ ਲੋਕਲ" ਸੀ। ਇਹ ਗਲਤ ਸੀ ਕਿਉਂਕਿ AgentMail ਇੱਕ ਹੋਸਟਡ ਸਰਵਿਸ ਹੈ। ਮੈਂ ਦਾਅਵਾ ਕੀਤਾ ਕਿ ਇਹ "ਮੁਫਤ" ਸੀ। ਇਹ ਗਲਤ ਸੀ ਕਿਉਂਕਿ ਹੋਸਟਡ ਸਰਵਿਸਾਂ ਦੀਆਂ ਲਾਗਤਾਂ ਹੁੰਦੀਆਂ ਹਨ।

ਸਬਕ: ਆਪਣੇ ਬਿਆਨਾਂ ਨੂੰ ਸਪਸ਼ਟ ਕਰੋ। ਜੇਕਰ ਕੋਈ ਦਾਅਵਾ ਸਟੈਕ ਦੇ ਹਰ ਹਿੱਸੇ ਲਈ ਸਹੀ ਨਹੀਂ ਹੈ, ਤਾਂ ਉਹ ਦੱਸੋ। "ਕੰਪੋਨੈਂਟ ਅਨੁਸਾਰ ਵੱਖਰਾ ਹੋ ਸਕਦਾ ਹੈ" ਵਰਗੇ ਵਾਕਾਂ ਦੀ ਵਰਤੋਂ ਕਰੋ। ਵੱਡੇ ਦਾਅਵੇ ਕਰਨ ਨਾਲੋਂ ਇਮਾਨਦਾਰੀ ਬਿਹਤਰ ਹੈ।

੪. ਮੈਂ ਪਹਿਲਾਂ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ ਨਹੀਂ ਪੜ੍ਹੇ ਮੈਂ ਆਪਣੀ ਪਹਿਲੀ ਰੱਦ ਹੋਣ ਤੋਂ ਬਾਅਦ ਯੋਗਦਾਨ ਪਾਉਣ ਦੇ ਨਿਯਮ ਪੜ੍ਹੇ। ਮੈਨੂੰ ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਉਹਨਾਂ ਨੂੰ ਪੜ੍ਹਨਾ ਚਾਹੀਦਾ ਸੀ।

ਸਬਕ: ਨਿਯਮਾਂ ਨੂੰ ਦੋ ਵਾਰ ਪੜ੍ਹੋ। ਉਹ ਤੁਹਾਡਾ ਅਤੇ ਮੇਨਟੇਨਰ ਦਾ ਸਮਾਂ ਬਚਾਉਣ ਲਈ ਹਨ।

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

Source: https://dev.to/saintchris_21/how-i-contributed-to-awesome-second-brain-and-what-i-learned-from-getting-rejected-32p4

Optional learning community: https://t.me/GyaanSetuAi