Background Image
오픈소스 이야기
2009.03.05 05:37

CUBRID 오픈소스 프로젝트 WIKI 개편

조회 수 38495 추천 수 0 댓글 0
?

단축키

Prev이전 문서

Next다음 문서

크게 작게 위로 아래로 댓글로 가기 인쇄 첨부

약 2주 전엔 nFORGE의 위키를 개편하였다. (작업 날짜를 보니 10일 정도 지났군요.) 위키 정리한 내용을 블로그에 정리해야지라고 생각만 하다보니 벌써 10일이나 흘렀다.

개편 이유

오픈 소스 프로젝트를 준비하면서 딱딱한 위키 페이지보단 개발자들이 정감있게 읽을 수 있는 것이 목표였다. 그래서 캐주얼하게 위키를 구성하다가 보니 위키 페이지에서 내용을 찾는 것이 어렵게 구성되었다. 오픈 소스 프로젝트에 대한 벽을 없애는 것을 치중하니 경직된 느낌을 주지 않기 위해 노력했다. 아래 그림을 보면 쉽게 이해가 될 것이다. (정말 문장 하나하나가 캐주얼하고 개발자의 위트를 발휘하려고 노력했었다.)

결과적으로 처음 위키에 방문한 사람은 모든 내용을 정독하지 않으면 안 되는 형태였다. 11월 20일에 오픈하고, 1달이 지난 시점에서 복잡하다는 느낌이 부쩍 많이 들었다. 업무는 계속 주어지니까 눈 앞에 깔끔한 위키를 만드는 것이 만만치 않았다.



이 차장님도, 오 과장님도 똑같이 느끼고 있었을 것이다. 그러던 중 오 과장님이 다른 오픈 소스 프로젝트랑 자주 비교하다가 보니까 “이건 아니다!!”란 선언을 했고, 우리도 그와 관련해서 이미 공감하고 있었기 때문에 더 고민하지 않고 작업을 하기로 결심했다. 모든 일은 하자고 말이 나왔을 때 하지 않으면 우리의 기억 저편으로 사라지기 때문이다.

작전

우리의 창의력이란 게 보통 사람들 수준이라서 어떤 내용을 어떻게 정리할지 결정하기 전에 어떤 페이지를 참고할 것인지를 조사했다. 비슷한 오픈 소스 프로젝트들은 어떤 내용을 어떻게 정리하는지 조사하니 그나마 PostgreSQL이 맘에 들었다. 구성은 여기 내용을 참고하기로 하고, 내용 분류를 어떤 식으로 할까 고민을 하였다.

“개발자들이 와서 헷갈리는 이유가 뭘까?” 하는 화두를 해결하기 위해 고민을 했다. 우리의 결론은 제품 자체, 오픈 소스 프로젝트 자체, 그리고 문서로 분류를 해 보았고, 특히 오픈 소스 프로젝트에서 개발자들이 할 일이 무엇인지를 명확하게 정리하기로 의견을 모았다. 이전 페이지는 개발자는 이런 일을 할 수 있고, 테스터는 저런 일을 할 수 있다고 얘기하니까 페이지가 복잡하였다. 단순하게 코드 패치하는 방법, 문서 작성하는 방법, 버그 리포팅 하는 방법과 같이 단순하게 정리하였다.

작업 시작!

내가 위키 페이지를 구성한 원흉이었기 때문에 구 페이지 백업은 나의 담당이었다. 난 열심히 위키 소스를 열심히 백업하여 문서를 작업자들에게 배포하였다. 이제 작업하기로 한 날만 오기를 기다리고 있었다.

작업 하기로 한 날, 출근하는데 서비스 중인 페이지를 큰 손실이 없이 엎어치는 방법이 뭘까라고 고민이 되었다. 오 과장님이 지금 서비스 되고 있는 페이지의 아래에 그대로 작업하자는 혜안을 제시하였다.



우리의 작업은 그렇게 시작되었다. 아침 나절에 모두 하기로 하였는데, 내가 하기로 한 부분은 개발자들이 참여하는 방법이라서 전면적인 개편이었기 때문에 조금 오래 걸렸다. 하지만 점심 먹고 들어와서 마무리하여 모두 완성하였다. 우리는 박수를 치고 기뻐했다.
 
근데 문제점이 하나둘씩 보이기 시작하였다. 옆 팀에서 “빌드하기” 페이지를 보고 있는데, 히스토리에서 뒤져서 보고 있는 것을 발견했다. 아차 싶어서 얼른 예전 페이지를 주욱 보니까 “빌드하기”와 “소스 구조” 의 링크가 빠진 것이다. 빌드하기는 처음 시도하는 사람들이 많이 보는 것이기 때문에 꼭 해야 하는 것이고, 소스 구조는 잘 보지 않는 페이지이긴 하지만, 앞으로 계속 작업을 할 것이기 때문에 남겨둬야 하는 페이지인 것이다. 빠진 페이지를 찾고 모두 링크를 정리하였다.

작업 완료!

짜잔! 우리의 노력으로 페이지를 아래와 같이 단순하게 정리하게 되었다. 깔끔하고 좋지 않나? 읽을 거리가 많은 것보단 내용이 한 눈에 들어오는 게 역시 편한 것 같다.



작업 후기

정말 개편을 결심하고 실제 작업한 시간은 Net로 보면 4시간~5시간 정도인 것 같다. 하지만 팀장님과 랩장님께 상의하면서 할지, 대략 방향만 상의하고 그냥 후다닥 작업을 할지 초반에 갈피를 잡을 수가 없었다. 사실 방향만 상의하고 실무자들 선에서 하면 될 것이라고 생각은 했지만, 자신은 없었다.

오픈 소스 프로젝트는 수많은 개발자의 눈을 무시할 수 없고, 사소한 것 하나하나가 개발자들의 생각에 영향을 주는 것이므로 뭘 해도 조심스러울 수 밖에 없다. 그래서 모든 것이 팀장님과 랩장님은 알아서 실무자 선에서 알아서 해주길 바라겠지만, 실무자들은 살짝 부담스러울 수 밖에 없는 것이다.

페이지 정리는 했는데 앞으로 어떻게 내용을 채울지가 솔직히 고민이다. 오픈 소스 프로젝트의 꽃이라면 뭐니뭐니해도 개발자 친화적이고 풍부한 문서가 아니겠는가?! Documentation 분류 아래에 수많은 문서를 채워서 검색 기능을 추가하자는 의견이 나올 때까지 글을 채워보고 싶다.

우리 모두 큐브리드 사용 Tip이나, 개발 Tip 작성하러 가요~. 1인 1Tip 캠페인을 벌여보는 건 어떨까?


  1. 도쿄 한중일 OSS 활성화 포럼 참관기

    동북아 OSS 활성화 포럼은 2003년 9월 한중일 IT장관회의에서 공개SW 분야에 대한 3국 협력 합의 이후 2004년 4월에 구성되었으며, 정부차원의 국장급 회의와 민간차원의 활성화 포럼으로 운영되고 있습니다. (포럼 내에는 기술개발, 인력양성, 표준화 워킹그룹이 운영되어 상호 협력 교류를 하고 있음) 매년 한중일이 돌아가면서 행사를 주최하는데, 금년에는 10월 19일부터 20일까지 일본 도쿄에서 진행되었고, 200명 이상의 한중일 공개SW 관계자(정부, 학계/연구소, 기업, 커뮤니티)가 참석을 하여 오픈소스 SW에 대한 뜨거운 열정과 정보를 교류하였습니다. 큐브리드는 정보 교류 세션(Information Exchange Session on Free Theme)에 한국측 대표로 선정되어 발표를 진행하게 되었으며, 마침 CUBRID 글로벌 프로젝트/커뮤니티를 준비하고 있는 상황이라 중국 및 일본 참석자 분들에게 CUBRID 제품 및 커뮤니티 활동에 대한 좋은 소개의 시간을 갖게 되었습니다. 또한, 오픈소스 관련 기업, 커뮤니티 분들을 많이 만나게 되었는데, 아시아눅스 일본 카운터파트인 미라클(MIRACLE) 대표 Takashi Kodama, SRA OSS 대표 Tatsuo Ishii, 일본 최대 오픈소스 커뮤니티의 Miyahar...
    Date2009.10.29 Category오픈소스 이야기 By정병주 Views46621 Votes0
    Read More
  2. 오픈소스 SW에 대한 최신 설문조사 결과 - CUBRID 2등?!

    지난 4월 14일 ZDNet Korea가 주관/주최한 “Advance Computing Conference 2009” 행사에 큐브리드가 협찬사로 참여를 했다. 부제가 “오픈소스 최신기술 및 산업전망 컨퍼런스”로서 오픈소스 관련 국내 최초의 행사가 아니었나 생각된다. 컨퍼런스 참가 후기는 멜라니님이 작성하신 '오픈소스 최신 기술 동향 및 산업 전망 컨퍼런스’ 참여 후기를 참고하시면 되며, 협찬사에 제공된 설문조사 결과 중 일부를 정리해 보았다. 참고로, 총 참관객은 588명이었고, 이중 402명이 설문조사에 응답을 했다. 우선, 참관객 업무영역 현황을 살펴 보니 연구/개발, 엔지니어/프로그래머, 시스템운영/관리, 기술지원이 70.1%로 대부분 개발이나 기술 계통 업무를 담당하고 계신 분들이 참석을 했다(사실, 넥타이를 매고 오신 분들이 많아서 살짝 걱정을 했음 ^^). 또한, 유료 컨퍼런스였음에도 불구하고 학생들이 13%나 차지하고 있어 오픈소스에 대한 높은 관심을 느낄 수 있었다. 귀사에서 현재 쓰고 있는 오픈소스 SW는 어떤 것입니까? OS (리눅스겠죠? ^^)가 40.7% 차지해서 오픈소스 SW 영역 중 가장 큰 비중을 차지하고 있으며, 이어서 미들웨어가 20.8%, DBMS가 20.5%를 차지하고 있...
    Date2009.04.29 Category오픈소스 이야기 By정병주 Views48787 Votes0
    Read More
  3. CUBRID 오픈 소스 프로젝트에 코드기여하기

    CUBRID 오픈 소스 프로젝트(이하 프로젝트)에 코드를 기여하고 싶다고 문의하는 개발자가 줄을 잇는 사태에 대비하여 블로깅을 미리 해 본다. 프로젝트에서 할 수 있는 일은 아래와 같이 6가지이다. CUBRID 프로젝트 홈페이지에서 제공하는 메뉴와 일을 분류해 보면 다음과 같다. 1. 포럼 메뉴: 신규 개발 제안 이슈, 문서 등의 이슈, 토론 등 자유 게시 성격 - 관련 기능: 새로운 기능 제안하기, 사용자 문서 작성하기 2. 이슈 메뉴: 코드리뷰가 예상되는 이슈 - 관련 기능: 버그리포트하기, 코드리뷰하기 3. 코드 메뉴 - 관련 기능: 코드 기여하기 4. 다운로드 메뉴 이 중 많은 개발자들이 관심을 가지는 코드 기여하기에 대해서 살펴 보자. 프로젝트 멤버의 권한 프로젝트에 참여하기 위해서 꼭 멤버로 가입해야 하는가? 그렇지 않다. 2009년 4월 15일 현재 프로젝트 멤버와 비멤버는 권한의 차이는 없다. 가입을 하지 않더라도 프로젝트에 기여한 사람이 누군지 확인할 수 있도록 Nickname을 사용하면 좋겠다. Nobody 상태이면 기여한 사람이 누군지를 알 수도 없고, 해결한 이슈에 대해서 결과를 알려줄 수도 없기 때문이다. 프로젝트 멤버의 권한은 운영의 편의성을 고려...
    Date2009.04.21 Category오픈소스 이야기 By일동차렷? Views78445 Votes0
    Read More
  4. 2회 CUBRID Inside 후기

    지난 3월 24일, 고민해오던 2회 CUBRID Inside가 끝났다. 1회 때의 처음의 설레임과 아쉬움보다는, 이번 CUBRID Inside에서는 나 스스로 고민하던 것에서 해결할 수 있는 계기가 되었고, 내가 해야 할 일에 대해서 고민을 시작할 수 있었다. 준비한 만큼 느끼는 것이 아닐까 싶다. 또한, 전국에서 참여하는 CUBRID Inside라 그런지 항상 참가자들에게 고마움을 느낀다. 주제 준비 1회 CUBRID Inside에 참여했던 사람들 중에서 주제 발표를 신청하는 것을 원했기 때문에 미리 발표자를 공개적으로 소집하였다. 혹시나 하는 마음에 공지를 했던 것이긴 했지만 실제로 신청하는 사람이 없으니 좀 아쉽긴 했지만 주변 사람들 중에서 발표자를 찾아야 했다. 최근의 개발 내용 중 “메모리 매니저 변경”이 CUBRID 소스에 관심이 있는 사람들에게 재미를 줄 수 있을 것 같아서 추천하였고, 결국 “CUBRID 오픈 소스의 취지”,”CUBRID 클러스터 프로젝트 소개”,”메모리 매니저 변경”가 주제로 선정되었다. 하지만 CUBRID Inside에서 초급자가 들을 수 있는 세션도 필요하다는 의견이 있어서 급하게 “오픈 프로젝트의 개발 프로세스 안내”를 추가하였다. 다른 것들은 오프라인으로 같이 얘...
    Date2009.04.03 Category오픈소스 이야기 By일동차렷? Views36602 Votes0
    Read More
  5. CUBRID 오픈소스 프로젝트 WIKI 개편

    약 2주 전엔 nFORGE의 위키를 개편하였다. (작업 날짜를 보니 10일 정도 지났군요.) 위키 정리한 내용을 블로그에 정리해야지라고 생각만 하다보니 벌써 10일이나 흘렀다. 개편 이유 오픈 소스 프로젝트를 준비하면서 딱딱한 위키 페이지보단 개발자들이 정감있게 읽을 수 있는 것이 목표였다. 그래서 캐주얼하게 위키를 구성하다가 보니 위키 페이지에서 내용을 찾는 것이 어렵게 구성되었다. 오픈 소스 프로젝트에 대한 벽을 없애는 것을 치중하니 경직된 느낌을 주지 않기 위해 노력했다. 아래 그림을 보면 쉽게 이해가 될 것이다. (정말 문장 하나하나가 캐주얼하고 개발자의 위트를 발휘하려고 노력했었다.) 결과적으로 처음 위키에 방문한 사람은 모든 내용을 정독하지 않으면 안 되는 형태였다. 11월 20일에 오픈하고, 1달이 지난 시점에서 복잡하다는 느낌이 부쩍 많이 들었다. 업무는 계속 주어지니까 눈 앞에 깔끔한 위키를 만드는 것이 만만치 않았다. 이 차장님도, 오 과장님도 똑같이 느끼고 있었을 것이다. 그러던 중 오 과장님이 다른 오픈 소스 프로젝트랑 자주 비교하다가 보니까 “이건 아니다!!”란 선언을 했고, 우리도 그와 관련해서 이미 공감하고 있었기 ...
    Date2009.03.05 Category오픈소스 이야기 By일동차렷? Views38495 Votes0
    Read More
  6. No Image

    CUBRID Inside, 첫 삽을 뜨다.

    2009년 1월 29일, 드디어 CUBRID Inside 를 성공리에(?) 마쳤습니다. 기획단계부터 행사 당일까지를 짤막하게 스케치 해 보고자 합니다. 방향 선정 "소스 구조 설명이라는 주제로 CUBRID Inside를 광고하면 사람들이 과연 얼마나 신청할까?" 하는 의문 때문에 기획 단계에서 난항을 겪었습니다. 특히나, nFORGE 사이트에서는 개발자들의 반응이 별로 보이지 않았기 때문에 오프라인 모임이 성공할지에 대한 두려움이 컸습니다. 다양한 논의 끝에 내부 세미나를 동영상으로 촬영하고 이를 공개하는 방향으로 추진하던 중, "CUBRID Inside는 밖에서 실제로 개발자를 만나는 행사여야 한다."는 기본 방침에 벗어난다 싶어 오프라인 모임을 하기로 확정하였습니다. 참가자 신청 참가 신청하는 사람이 얼마나 될까? 한 명도 관심을 보이지 않으면 어떡하지? 하는 걱정이 제일 컸습니다. 자전거를 처음 탈 때 시원한 바람을 느낄 수 있다는 설렘과 함께 넘어지면 다칠지도 모른다는 두려움이 드는 것처럼, CUBRID Inside를 처음 준비하면서 모든 결정에 설렘과 두려움이 교차하였지만, CUBRID 관련 오픈 소스 프로젝트에 참가하고 있는 개발자들에게 메일을 보내자마자, 참가 신청 메...
    Date2009.02.04 Category오픈소스 이야기 Bybrightest Views38211 Votes0
    Read More
  7. 2008년 큐브리드 핵심 키워드 - CUBRID 오픈소스화

    지난 한 해 큐브리드의 핵심 키워드는 “CUBRID 오픈소스화”가 아닌가 합니다. 2006년 5월에 선언했던 무료 라이선스 정책에서 한 걸음 더 나아가 작년 11월 CUBRID를 오픈소스로 전환함으로써 명실공히 국내에서 대표적인 오픈소스 소프트웨어로 포지셔닝을 시작하였고, 국내 개발자/사용자와 함께 만들어가는 DBMS를 지향하고자 하는 큐브리드의 모습에 많은 분들의 관심이 있었습니다. “앤드류 그로브 승자의 법칙”이라는 책에 전략적 변곡점(strategic inflection point)이라는 용어가 나옵니다. 변화가 시작되는 지점이라는 의미인데, 인텔은 세계 최초 메모리(DRAM) 개발업체라는 포지셔닝을 과감히 포기하고 마이크로프로세서로 승부를 거는 전략을 취했습니다. 큐브리드는 인텔처럼 사업 분야의 변경을 가한 것은 아니지만, DBMS 원천 소스를 오픈하고 참여형 프로젝트로 전환함으로써 국산 DBMS의 성공 가능성을 한층 높였고, CUBRID의 오픈소스화가 국내 DBMS 시장에 새로운 변화를 창출하는 변곡점이 되기를 바랍니다. 큐브리드는 개발자 확산과 적용 확산이라는 목표를 향해 다시 한번 신발끈을 꽉 조여 매고 힘찬 발걸음을 내 딛도록 하겠습니다. 초심을 잊지 않고...
    Date2009.01.02 Category오픈소스 이야기 By정병주 Views60743 Votes0
    Read More
Board Pagination Prev 1 2 Next
/ 2

Contact Cubrid

대표전화 070-4077-2110 / 기술문의 070-4077-2113 / 영업문의 070-4077-2112 / Email. contact_at_cubrid.com
Contact Sales