오픈소스 저장소는 코드만 있는 장소가 아닙니다. 누가, 왜, 어떤 문제를 해결하려고 만들었는지 설명하면 저장소 자체가 콘텐츠가 됩니다. GemTR.kr 포털에서 GitHub 프로젝트를 따로 모으는 이유도 단순한 자기소개가 아니라, 도구의 사용 맥락을 보여 주기 위해서입니다.
저장소 링크만으로는 부족하다
방문자가 저장소 이름만 보고 무엇을 하는 프로젝트인지 이해하기는 어렵습니다. Daegu_WA, RB_FWord_Search, Jinro_linker 같은 이름은 개발자에게는 익숙해도 처음 보는 사람에게는 맥락이 필요합니다. 그래서 포털 카드에는 한 줄 설명, 분야 라벨, 저장소 링크를 함께 둡니다.
이 짧은 설명은 README를 대체하지 않습니다. 대신 사용자가 “이 저장소를 열어 볼 가치가 있는지” 빠르게 판단하게 도와줍니다.
프로젝트는 생태계를 만든다
GemTR은 AI TRPG 도구이고, Daegu_WA는 지역 날씨 앱이며, Class_management는 학급 운영 도구입니다. 겉보기에는 서로 다른 프로젝트지만, 모두 웹에서 바로 접근 가능한 문제 해결 도구라는 공통점이 있습니다. 오픈소스 링크를 포털에 모으면 이런 공통점이 드러납니다.
또한 프로젝트가 완성품인지, 실험인지, 학습 도구인지 구분해 보여 줄 수 있습니다. 사용자는 안정적인 서비스와 실험적 저장소를 다르게 기대해야 합니다.
포털의 설명은 짧아야 한다
오픈소스 프로젝트 설명은 길수록 좋은 것이 아닙니다. 포털에서는 핵심 목적만 말하고, 자세한 설치법과 코드 구조는 GitHub에 맡기는 편이 낫습니다. 포털은 지도이고, 저장소는 실제 작업장입니다.
좋은 포털 카드는 “무엇을 해결하는가”, “어디에서 볼 수 있는가”, “현재 상태가 무엇인가”를 담습니다. 이 세 가지가 있으면 방문자는 다음 행동을 결정할 수 있습니다.
콘텐츠 품질과 신뢰
광고 심사 관점에서도 오픈소스 프로젝트를 맥락 없이 나열하는 것보다, 각 프로젝트의 목적과 연결 관계를 설명하는 편이 더 건강합니다. 사이트가 실제로 운영되는 프로젝트 생태계를 담고 있다는 신호가 되기 때문입니다.
GemTR.kr는 프로젝트를 숨기지 않고, 실험과 운영 상태를 구분해 보여 주는 방향으로 관리합니다.