영상으로 보긴 하지만 청중들의 반응은 어느 정도 느낄 수 있습니다. 애매하게 이론적인 내용을 나열하거나 뭔가 명확하지 않은 경험을 공유하는 경우에는 반응이 좋지 않구요. 잘 정리된 내용으로 자신의 경험을 공유하는 내용은 반응이 좋습니다.
이번 영상은 후자입니다. 정말 깔끔하게 테크니컬 라이터를 희망하는 이들이 오픈소스 프로젝트에서 경험을 쌓기 위해 필요한 것들을 순서대로 설명해줍니다. 물론 기술을 어떻게 습득하는지까지 다루지는 않습니다(이건 프로젝트에 따라 다르니깐요). 대신 오픈소스 프로젝트를 찾고 살짝 들여다보고 조금씩 발을 담그기까지 과정을 자세하게 설명해 주고, 이런 과정을 통해서 내가 얻을 수 있는 것을 정리해 줍니다. 오픈소스 프로젝트는 그냥 자원봉사 같은 거 아니냐고 생각할 수 있지만, 아직 경력이 없는 상태에서 오픈소스 프로젝트에 참여하는 과정을 통해 얻을 수 있는 것들을 본인의 경험을 비추어 안내해주고 있습니다.
물론 발표자도 처음부터 성공적으로 오픈소스 프로젝트를 참여한 것은 아니고 약간 이불킥이 될 수 있는 프로젝트 경험도 있었다고 합니다.
원래 전공은 문헌정보학이고 법률 사서로 15년간 일한 후에 다시 학교를 들어가 테크니컬 라이팅을 전공하고 인턴과 오픈소스 프로젝트를 거쳐 작년 10월부터 정규직 테크니컬 라이터로 일하고 있다고 합니다. 그래서 아예 바닥부터 시작한 케이스는 아니지만 어찌되었든 독특한 커리어이긴 합니다.
오픈소스 프로젝트를 참여하라는 조언은 많이 하지만, 어떤 오픈소스 프로젝트를 찾아야 할지는 좀 막막합니다. 그럼 점에서 발표자의 조언은 깔끔하네요.
- 강력한 지원을 받는 오픈소스 프로젝트
예를 들어 주요 메인테이너가 어떤 회사에 소속되어 있는지
그 회사가 실제 그 오픈소스 프로젝트를 활용하고 있는지
- 실제 활동하고 있는 오픈소스 프로젝트
지속적으로 버전 업데이트가 되고 있는지
질문에 대한 답변이 바로 바로 처리가 되고 있는지
- 도움이 필요한 오픈소스 프로젝트
오픈소스 프로젝트를 찾아보고 맘에 드는 오픈소스 프로젝트를 발견했다면 다음과 같은 단계로 좀 더 자세한 정보를 수집해 보고 분위기를 익혀보세요.
1. Find the project’s repository and figure out where the docs are stored.
2. Find the contributing guidelines.
3. Look for synchronous virtual meetings to attend.
4. Find the asynchronous communication tool.
5. Subscribe to all relevant repositories.
6. Read the existing docs.
7. Look for third-party materials, like blog posts or O’Reilly books.
8. Use the software!
그 외 여러가지 조언을 해주고 있는데요. 리뷰어의 말에 상처받지 않도록 하는 것도 중요하다고 합니다.
리뷰어 역시 오픈소스 프로젝트에 기여하는 참여자인데, 여러 사람이 참여하다 보면 서로 상처를 주는 경우가 많다고 하네요.
뭐 이건 어떤 모임이든 마찬가지니깐요.
Q&A에서 오픈소스 프로젝트에 참여할 때 그 기술을 어떤 식으로 배우는가에 대한 질문이 있었는데, 일단 발표자는 오픈소스 프로젝트에 참여하는 시점에 쉬고 있어서 좀 더 여유가 있었다고 합니다. 그렇지 않다면 쉽지 않을 수도 있구요.
* 저도 작년에 오픈소스 프로젝트에 살짝 발만 담근 적이 있는데, 이게 프로세스 자체는 가이드를 따라가면 되는거라 어렵지 않지만 내가 어떤 문서에 기여할지를 판단하는 것은 쉽지 않더군요. 발표자는 오타 수정부터 시작해도 된다고 합니다. 처음부터 너무 큰 기여를 하려고 하지 말고, 정말 오타를 찾고 수정하는 것부터 해도 괜찮습니다.
2025.08.08 - [그냥 블로그] - 표준프레임워크 개발가이드 컨트리뷰션에 도전
발표 슬라이드는 다음 링크에서 참고할 수 있습니다.
https://docs.google.com/presentation/d/1KZ2cELUfQxjGvpD9LRTq0tGlVm_X5XjIqjSNm7MLOc4/edit?slide=id.p#slide=id.p
https://youtu.be/SqryGnlzTDs?si=HiRu-UYEdGtiUZWJ
