ఒక PR ని మెర్జ్ చేసే ముందు నేను రెండుసార్లు ఎందుకు తిరస్కరించబడ్డాను

నేను Awesome Second Brain కి కాంట్రిబ్యూట్ చేయడానికి ప్రయత్నించాను. Awesome Second Brain అనేది AI మెమరీ మరియు నాలెడ్జ్ సిస్టమ్స్ కోసం ఒక ఓపెన్-సోర్స్ రిసోర్స్. దీనికి 200 కంటే ఎక్కువ స్టార్స్ ఉన్నాయి మరియు చాలా కఠినమైన నియమాలు ఉన్నాయి. నేను Hermes Agent, Obsidian, మరియు Honcho లతో కూడిన ఒక కాంప్లెక్స్ స్టాక్‌ను సబ్మిట్ చేశాను.

నేను రెండుసార్లు విఫలమయ్యాను. నా pull request మెర్జ్ కావడానికి మూడు రౌండ్ల ఫిక్స్‌లు అవసరమయ్యాయి. నేను చేసిన తప్పులు మరియు నేను నేర్చుకున్న విషయాలు ఇక్కడ ఉన్నాయి.

𝟭. నేను డాక్యుమెంటేషన్‌కు బదులుగా జ్ఞాపకశక్తిపై ఆధారపడ్డాను ఉన్నాయని నేను అనుకున్న కమాండ్లను ఉపయోగించి ఒక సెటప్ గైడ్‌ను రాశాను. ఒక నిర్దిష్ట ఫోల్డర్‌లో కాన్ఫిగరేషన్ ఫైల్ ఉంటుందని నేను ఊహించాను. ఒక CLI స్క్రిప్ట్ అందుబాటులో ఉంటుందని అనుకున్నాను. నేను తప్పు చేశాను. ఆ రెండూ లేవు.

పాఠం: ఎప్పుడూ జ్ఞాపకశక్తి ఆధారంగా కమాండ్‌ను రాయకండి. అధికారిక డాక్యుమెంటేషన్‌ను తెరవండి. ఖచ్చితమైన పేజీని వెతకండి. ఖచ్చితమైన కమాండ్‌ను కాపీ చేయండి. ఒకవేళ మీకు అది దొరకకపోతే, దానిని చేర్చకండి.

𝟮. నా మెటాడేటా తప్పుగా ఉంది నేను కంపెనీ పేర్లను తారుమారు చేశాను. Obsidian ను Plastic Labs తయారు చేసిందని నేను అనుకున్నాను. వారు చేయలేదు. మొత్తం స్టాక్ ఓపెన్ సోర్స్ అని నేను పేర్కొన్నాను. అది నిజం కాదు. Obsidian మరియు AgentMail ప్రొప్రైటరీ (proprietary) సాఫ్ట్‌వేర్‌లు.

పాఠం: ప్రతి వివరాలను సరిచూసుకోండి. మెయింటైనర్, లైసెన్స్ మరియు రిపోజిటరీ స్టేటస్‌ను తనిఖీ చేయండి. ఊహించి చెప్పకండి.

𝟯. నేను ఆధారాలు లేకుండా సాధారణీకరించి చెప్పాను మొత్తం స్టాక్ "అంతా లోకల్" (all local) అని నేను పేర్కొన్నాను. AgentMail అనేది ఒక హోస్టెడ్ సర్వీస్ కాబట్టి ఇది తప్పు. ఇది "ఉచితం" అని కూడా చెప్పాను. హోస్టెడ్ సర్వీస్‌లకు ఖర్చులు ఉంటాయి కాబట్టి ఇది కూడా తప్పు.

పాఠం: మీ స్టేట్‌మెంట్లను స్పష్టంగా చెప్పండి. ఒకవేళ స్టాక్‌లోని ప్రతి భాగం గురించి ఒక విషయం నిజం కాకపోతే, దానిని స్పష్టంగా చెప్పండి. "కంపొనెంట్లను బట్టి మారుతుంది" (varies by component) వంటి పదబంధాలను ఉపయోగించండి. అతిగా చెప్పడం కంటే నిజాయితీగా ఉండటం మేలు.

𝟰. నేను మొదట గైడ్‌లైన్స్‌ను చదవలేదు మొదటిసారి తిరస్కరించబడిన తర్వాతే నేను కాంట్రిబ్యూషన్ నియమాలను చదివాను. నేను పని ప్రారంభించకముందే వాటిని చదివి ఉండాల్సింది.

పాఠం: నియమాలను రెండుసార్లు చదవండి. అవి మీ సమయాన్ని మరియు మెయింటైనర్ సమయాన్ని ఆదా చేయడానికి ఉద్దేశించినవి.

𝗙𝗶𝗻𝗮𝗹 𝗧𝗵𝗼𝘂𝗴𝗵𝘁𝘀 తిరస్కరణలు బాధాకరంగా ఉంటాయి. కానీ వచ్చిన ఫీడ్‌బ్యాక్ సరైనది మరియు ఉపయోగకరమైనది. చివరి వెర్షన్ మరింత ఖచ్చితంగా మరియు స్పష్టంగా ఉంది. అతిగా చేయడానికి ప్రయత్నించే ముందు, చిన్నవి మరియు సరైన కాంట్రిబ్యూషన్లపై దృష్టి పెట్టండి.

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