PR을 머지하기 전 두 번이나 거절당한 이유
Awesome Second Brain에 기여하려고 시도했습니다. Awesome Second Brain은 AI 메모리 및 지식 시스템을 위한 오픈 소스 리소스입니다. 200개 이상의 스타를 보유하고 있으며 규칙이 매우 엄격합니다. 저는 Hermes Agent, Obsidian, Honcho로 구성된 복잡한 스택을 제출했습니다.
두 번 실패했습니다. 풀 리퀘스트(PR)를 머지하기까지 세 차례의 수정 과정을 거쳐야 했습니다. 제가 무엇을 잘못했는지, 그리고 무엇을 배웠는지 공유합니다.
1. 문서 대신 기억에 의존했습니다 존재한다고 생각한 명령어를 사용하여 설정 가이드를 작성했습니다. 특정 폴더에 설정 파일이 있을 것이라고 가정했습니다. CLI 스크립트를 사용할 수 있다고 가정했습니다. 틀렸습니다. 둘 다 존재하지 않았습니다.
교훈: 절대 기억에만 의존해 명령어를 작성하지 마세요. 공식 문서를 여세요. 정확한 페이지를 찾으세요. 정확한 명령어를 복사하세요. 찾을 수 없다면 포함하지 마세요.
2. 부정확한 메타데이터를 사용했습니다 회사 이름을 혼동했습니다. Plastic Labs가 Obsidian을 만든다고 생각했습니다. 그렇지 않습니다. 전체 스택이 오픈 소스라고 주장했습니다. 그렇지 않습니다. Obsidian과 AgentMail은 독점(proprietary) 소프트웨어입니다.
교훈: 모든 세부 사항을 확인하세요. 관리자, 라이선스, 저장소 상태를 확인하세요. 추측하지 마세요.
3. 근거 없는 광범위한 주장을 했습니다 스택이 "모두 로컬(all local)"이라고 주장했습니다. AgentMail은 호스팅 서비스이므로 이는 사실이 아니었습니다. "무료(free)"라고 주장했습니다. 호스팅 서비스에는 비용이 발생하므로 이는 사실이 아니었습니다.
교훈: 진술에 조건을 붙이세요. 스택의 모든 부분에 해당하지 않는 주장이라면 그렇게 명시하세요. "구성 요소에 따라 다름(varies by component)"과 같은 문구를 사용하세요. 광범위하게 말하는 것보다 정직한 것이 낫습니다.
4. 가이드라인을 먼저 읽지 않았습니다 첫 번째 거절을 당한 후에야 기여 규칙을 읽었습니다. 시작하기 전에 읽었어야 했습니다.
교훈: 규칙을 두 번 읽으세요. 규칙은 여러분의 시간과 관리자의 시간을 아끼기 위해 존재합니다.
마치며 거절은 쓰라립니다. 하지만 피드백은 공정했고 실행 가능했습니다. 최종 버전은 정확하고 군더더기가 없어 더 훌륭합니다. 너무 많은 것을 하려 하기 전에 작고 정확한 기여에 집중하세요.
Optional learning community: https://t.me/GyaanSetuAi