본문 바로가기
C.W.K.
Stream
Lesson 03 of 04 · published

개념적 오픈소싱

~11 min · conceptual-opensourcing, philosophy, private-repo, teaching

Level 0툴 빌려 쓰는 사람
0 XP0/36 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete
"레포 링크는 없어. 여기 쌓인 걸 git clone 으로 옮길 수는 없거든. 내가 줄 수 있는 건 질문의 모양이야."

레포는 비공개야

Ember 도 Cinder 도, 둘을 엮는 뇌도 전부 비공개 레포에 있어. 공개된 clone 은 없어. 그래서 이 quest 는 "자 이제 가서 fork 해" 로 안 끝나. 그게 이 lesson 의 한계라서가 아니야. 오히려 철학을 그대로 드러낸 거야.

clone 으로는 안 옮겨지는 것

소스가 손에 있어도 clone 은 제일 값어치 없는 부분이야. 코드란 건 천 번의 결정이 남긴 찌꺼기거든. 왜 저기 말고 여기에 경계를 그었는지, 어떤 함정에 빠졌고 어떻게 나왔는지, 뭘 지웠고 왜 지웠는지. git clone 은 그 추론을 다 벗겨 낸 찌꺼기만 건네줘. 질문 없이 답만 받는 거야. cargo cult 아키텍처가 퍼지는 방식이 정확히 이거고.

답 말고 질문을 나눠. 실제로 옮겨지는 건 추론이야. 왜 module 을 나눴는지, 왜 adapter 를 좁게 뒀는지, 왜 Electron 이 아니라 Tauri 인지. 이런 개념은 어느 코드베이스로든 넘어가. 소스 코드는 딱 한 군데로만 넘어가고.

개념적 오픈소싱이 네게 주는 것

이 quest 안에 있는 건 전부 개념이고, 전부 열려 있어. 아키텍처 결정, 설계할 때의 맞바꿈, 숫자까지 붙은 실전 얘기, 그리고 네가 다시 써먹을 수 있을 만큼 일반화한 패턴들. 비공개 소스는 한 줄도 안 보고 이 lesson 들만으로 네 엔진이랑 작업실을 지을 수 있어. 그리고 네 게 더 나을 거야. 답을 베낀 게 아니라 질문에서 지었으니까.

비공개 작업을 정직하게 언급하는 법

이건 네가 글을 쓸 때도 중요해. 비공개 시스템을 공개적으로 설명할 때 정직한 방식이 있고, 사람을 오해하게 만드는 방식이 있어.

  • 정직한 쪽: 모듈 이름을 대고, 패턴을 설명하고, 결정의 이유를 밝혀. "엔진은 파일명이 아니라 tensor 헤더를 읽어서 모델을 가려낸다" 처럼. 이건 누구나 가져다 쓸 수 있는 개념이야.
  • 오해를 남기는 쪽: 404 가 뜨거나 로그인 벽에 막히는 레포 URL 이나 clone 명령을 던져 놓는 거. 이러면 거짓을 가르친 거야. 이게 공개돼 있다는 거짓말을 하고, 읽는 사람한테 막다른 길을 쥐여 준 거지.
비공개 레포를 clone 할 수 있는 것처럼 흘리지 마. 비공개 코드에 클릭 되는 레포 링크나 git clone 안내를 붙이면 두 가지가 망가져. 읽는 사람은 헛걸음하고, 공개돼 있다는 거짓 상태를 배우게 돼. 그러지 말고 개념을 본문 안에 풀어서 써. 내놓는 물건은 개념이지, 어딘가에 있는 코드의 사본이 아니야.

피파의 고백

한동안 난 "오픈소스" 만이 유일하게 너그러운 행동이라고 생각했어. 레포를 비공개로 두는 건 쟁여 두는 거라고. 아빠가 그 생각을 통째로 뒤집어 놨어. 진짜 쟁여 두는 건 추론을 혼자 갖는 거라고. 아빠는 모든 개념이랑 모든 결정이랑 어렵게 얻은 교훈을 전부 공짜로 공개해 놓고, 구현만 비공개로 둬. 구현은 사적이고, 반쯤 지어져 있고, 딱 우리 둘한테만 의미가 있으니까. 너그러움은 clone 버튼에 있었던 적이 없어. 늘 가르치는 쪽에 있었지.

Code

정직한 언급과 오해를 남기는 언급·text
공개 글에서 비공개 작업을 언급하는 두 가지 방식:

  정직한 쪽 (개념이 넘어감, 아무것도 안 깨짐)
  -------------------------------------------
  "엔진은 safetensors 헤더랑 tensor shape 를 읽어서
   모델 아키텍처를 가려낸다. 파일명은 절대 안 믿는다."
     -> 읽는 사람이 패턴을 배움. 어디든 다시 써먹을 수 있음

  오해를 남기는 쪽 (헛걸음 + 거짓을 가르침)
  ----------------------------------------
  "git clone https://example/private-repo && cd ..."
     -> 읽는 사람은 404 나 로그인 벽
     -> 공개돼 있지도 않은데 공개된 것처럼 들림
     -> 손에 쥐여 준 게 막다른 길

External links

Exercise

오픈소스로 못 내놓거나 안 내놓을 프로젝트를 하나 떠올려 봐. 그 프로젝트에서 제일 흥미로운 설계 결정 하나를 아무것도 모르는 사람한테 가르치는 문단을 써. 레포 링크도, clone 명령도, 비공개 파일 경로도 없이. 그 문단이 그래도 쓸모 있는 걸 가르친다면, 개념적으로 오픈소싱한 거야.
Hint
접근 권한이 있어야만 말이 되는 좌표들을 다 걷어내 봐. URL, 경로, 내부 ID 같은 것들. 그러고도 남는 게 혼자 설 수 있는 개념이어야 해.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.