가이드

내 코드를 GitHub에도 두기

내 계정에 코드 사본을 둡니다. 개발자가 읽을 수 있는 형태입니다.

먼저 준비할 것

GitHub 계정이 필요합니다. 비어 있는 새 저장소로 시작하는 게 가장 쉽습니다.

  • GitHub 계정.
  • 저장소 하나. 처음에는 비공개로 비워 두는 편이 낫습니다.
  • 그 저장소를 누구에게 열어 줄지에 대한 결정.

01 · 왜 필요한지 먼저 정합니다

이유는 보통 둘입니다. 우리에게 기대지 않는 사본을 갖고 싶거나, 개발자가 같이 작업할 예정이거나. 둘 다 아니면 지금 안 해도 됩니다. 다른 기능이 이걸 필요로 하지 않습니다. 나중에 필요해지면 그때 붙여도 늦지 않습니다.

02 · 저장소를 연결합니다

프로젝트의 GitHub 화면에서 접근을 허락하고 저장소를 고릅니다. 접근 열쇠는 쓰기만 하고 연결 정보에는 적히지 않습니다. 그 정보가 새더라도 내 GitHub 계정이 넘어가지 않게 구조로 막아 둔 것입니다. 저장소는 처음에 비공개로 두는 편이 안전합니다. 필요해지면 그때 열면 됩니다.

03 · 상태를 읽습니다

화면에는 늘 다섯 가지 중 하나가 떠 있습니다. 뜻만 알아 두면 헤맬 일이 없습니다.

  • 같음 — 양쪽이 일치합니다
  • 앞섬 — 여기 변경이 저쪽에 아직 없습니다
  • 뒤처짐 — 저쪽 변경이 여기 아직 없습니다
  • 충돌 — 양쪽이 같은 곳을 고쳤습니다
  • 끊김 — 연결이 풀렸습니다

04 · 변경분을 올립니다

지킬 만한 지점이 되면 프로젝트 화면에서 올립니다. 그러면 GitHub 쪽 변경 이력이 한 덩어리가 아니라 단계별로 남습니다. 나중에 개발자가 읽을 때 쓸모 있는 형태가 이쪽입니다. 한 달치를 한 번에 올리면 무엇이 왜 바뀌었는지 아무도 되짚지 못합니다.

05 · 충돌은 사람이 정합니다

양쪽이 같은 파일을 고쳤으면 어떤 파일이 왜 부딪혔는지 알려 주고 멈춥니다. 자동으로 한쪽을 이기게 하지 않습니다. 그러면 누군가의 작업이 조용히 사라집니다. 양쪽을 보고 직접 고르세요. 자주 부딪히면 누가 어디를 맡을지부터 정하는 편이 낫습니다.

여기까지 되면 끝저장소에 지금 코드가 들어가 있고 상태가 “같음”으로 뜨면 됩니다.

막히면

게시하려면 이게 있어야 하나요? 아닙니다. 게시는 GitHub를 거치지 않습니다. 이건 내 사본을 갖는 일과 개발자와 같이 일하는 일을 위한 것입니다.

개발자가 저장소에서 바로 고쳐도 되나요? 됩니다. 그러면 여기 프로젝트는 뒤처짐으로 뜹니다. 이어서 작업하기 전에 그 변경을 가져오세요. 안 그러면 같은 앱을 두 벌 고치게 됩니다.

제 열쇠가 저장되나요? 저장되는 연결 정보에는 그걸 담을 자리가 아예 없습니다. 조심해서 다루겠다는 약속이 아니라 구조로 막아 둔 것입니다.

이어서 볼 것

여기 없는 데서 막히셨나요? 자주 묻는 질문을 먼저 보세요 — 거기에도 없으면 물어봐 주시면 답해 드립니다.