개인적으로 쓰려고 만든 CLI는 실행만 되면 충분합니다. 그러나 다른 사람이 사용하기 시작하면 설정 파일이 어디에 있는지, 오류가 무엇을 뜻하는지, 업데이트 후 되돌릴 수 있는지를 설명해야 합니다.이번 글에서는 작은 도구를 배포할 때 코드 기능보다 먼저 결정해야 할 네 가지를 정리합니다. 패키지 레지스트리를 쓰든 실행 파일을 배포하든 공통으로 적용되는 기준입니다.첫 실행에서 알아야 할 것을 줄입니다CLI 사용자는 README를 끝까지 읽지 않고 명령을 실행합니다. 첫 실행에서 필요한 설정이 무엇인지, 기본 출력이 어디에 저장되는지, 실패했을 때 다음에 무엇을 해야 하는지가 바로 보여야 합니다.저는 설정을 명령행 인자, 환경 변수, 설정 파일 세 층으로 나누고 우선순위를 문서에 고정합니다. 비밀 값은 로그..

오픈소스에 처음 기여하려고 하면 큰 기능부터 찾게 됩니다. 하지만 유지보수자가 반기는 기여는 작고 명확하며, 검토할 때 추가 질문이 적은 변경인 경우가 많습니다. 저도 처음에는 코드를 많이 바꾸는 것이 도움이 된다고 생각했습니다.이번 글에서는 문서 수정, 재현 가능한 이슈, 작은 코드 변경을 어떻게 고르고 준비할지 정리합니다. 실제 프로젝트마다 규칙이 다르므로, 아래의 절차를 그대로 복사하기보다 유지보수자의 시간을 줄이는 방향으로 적용하시기 바랍니다.첫 기여는 저장소의 사용 설명부터 읽습니다저장소의 README와 기여 안내는 단순한 예절 문서가 아닙니다. 브랜치 이름, 테스트 명령, 코드 스타일, 이슈 템플릿이 모두 들어 있습니다. 이 문서를 건너뛰면 작은 변경도 다시 설명해야 하는 일이 생깁니다.저는 ..

지금까지 학습한 내용을 온라인에서 공유드립니다. 소스코드 공유 사이트인 깃헙(www.github.com)을 이용해서 공유드립니다. 깃(git)과 깃헙(github)에 관해서는 프로그램에 대한 이해도가 어느정도 수준에 이르면, 전체적으로 한번 포스트를 작성해 보도록 하겠습니다. 샘플코드 : https://github.com/roslyndev/ExampleProject GitHub - roslyndev/ExampleProject: 블로그 예제 코드 블로그 예제 코드. Contribute to roslyndev/ExampleProject development by creating an account on GitHub. github.com 해당 웹사이트에 접속하면 우선적으로 회원가입부터 진행해 주세요. 깃허브 ..