포스트

[Phase 2 완료] Repository 기초 완료

[Phase 2 완료] Repository 기초 완료

Phase 2: Repository 기초 (Day 11-20) 완료!

학습 완료

Phase 2을 완주하셨습니다! 👏

Day 11-15: 저장소 시작

  • ✅ Repository 개념 이해
  • ✅ 첫 Repository 생성
  • ✅ README.md 기본/구조화/고급 기능

Day 16-20: 저장소 설정

  • ✅ .gitignore 이해 및 작성
  • ✅ 오픈소스 라이선스
  • ✅ 웹에서 파일 관리
  • ✅ Repository Settings

Phase 2의 핵심은 “저장소를 만들었다”가 아니라 “다른 사람이 들어와도 이해할 수 있는 저장소를 만들었다”입니다. README, .gitignore, License, Settings는 모두 프로젝트의 첫인상을 결정합니다.


완료 체크리스트

Phase 2를 제대로 완료했는지 확인하세요:

  • Repository 생성 및 초기 설정 완료
  • README.md 작성 및 문서화 완료
  • .gitignore와 라이선스 파일 추가
  • 웹 인터페이스로 파일 관리 가능
  • Repository 설정 최적화 완료
  • About 영역에 Description, Website, Topics 설정
  • Public/Private 선택 이유를 설명할 수 있음
  • 공개하면 안 되는 파일이 올라가지 않았는지 확인

복습 질문

Repository를 만들 수 있는 것과 “잘 관리되는 Repository”를 만들 수 있는 것은 다릅니다. 아래 질문으로 한 번 더 점검해보세요.

  1. Public Repository와 Private Repository는 언제 선택하나요?
  2. README의 첫 화면에는 어떤 정보가 가장 먼저 보여야 하나요?
  3. .gitignore에 넣어야 하는 파일의 공통점은 무엇인가요?
  4. MIT, Apache-2.0, GPL 계열 라이선스는 어떤 차이가 있나요?
  5. Repository Settings에서 Issues, Wiki, Discussions는 언제 켜고 끄나요?
  6. Topics를 설정하면 어떤 점이 좋아지나요?
  7. 공개 저장소에 실수로 API 키를 올렸다면 무엇을 해야 하나요?

특히 .gitignore와 라이선스는 나중에 되돌리기 번거로운 영역입니다. 프로젝트를 시작할 때부터 정리하는 습관을 들이세요.


좋은 Repository 기준

Phase 2가 끝난 뒤 Repository 하나를 골라 아래 기준으로 점검합니다.

항목 좋은 상태
이름 짧고 역할이 분명함
Description 한 문장으로 프로젝트 목적 설명
README 설치, 사용법, 주요 기능이 있음
.gitignore OS/언어/프레임워크별 불필요 파일 제외
License 공개 프로젝트라면 명시됨
Topics 검색 가능한 키워드 3개 이상
파일 구조 루트에 임시 파일이 섞이지 않음
Settings 필요 없는 Wiki/Discussions는 꺼져 있음
보안 .env, 토큰, 개인 정보가 없음

Repository는 코드 저장소이면서 동시에 프로젝트 소개 페이지입니다. 누군가 처음 들어와도 “무엇을 하는 프로젝트인지” 30초 안에 이해할 수 있어야 합니다.

아래 순서로 실제 저장소 하나를 점검해보세요.

1
2
3
4
5
1. 시크릿 창에서 저장소 URL 열기
2. README 첫 화면만 보고 프로젝트 목적이 이해되는지 확인
3. About의 Description과 Topics 확인
4. 파일 목록에 임시 파일, 로그, .env가 없는지 확인
5. Settings에서 필요한 기능만 켜져 있는지 확인

로그인한 내 화면이 아니라 외부 방문자의 화면으로 확인하는 것이 중요합니다.


Phase 2에서 만든 결과물

이번 Phase의 결과물은 “정리된 첫 저장소”입니다.

  • 프로젝트 Repository
  • 기본 README
  • 구조화된 README 섹션
  • .gitignore
  • License 파일
  • Repository Settings 점검

이 저장소는 Phase 3에서 로컬 Git 작업을 연결할 연습 대상이 됩니다.

결과물을 아래처럼 정리해두면 Phase 3로 넘어가기 쉽습니다.

1
2
3
4
5
6
7
8
## Phase 2 결과

- Repository URL:
- Public/Private 선택 이유:
- README에 포함한 섹션:
- 적용한 .gitignore 템플릿:
- 선택한 License:
- Phase 3에서 로컬로 clone할 계획:

이 기록은 나중에 포트폴리오 README를 개선할 때도 좋은 재료가 됩니다.


Phase 3 예고

Phase 3: Git 로컬 작업 (Day 21-30)

다음 10일간 배울 내용:

  • Git 설치 및 초기 설정
  • 로컬 저장소 초기화
  • git add와 commit
  • 커밋 메시지 작성법

목표: Git 로컬 작업 마스터하기


다음 Phase 준비물

Phase 3에서는 웹 UI가 아니라 내 컴퓨터에서 Git을 사용합니다.

  • Git을 설치할 컴퓨터
  • 터미널 또는 Git Bash
  • Phase 2에서 만든 Repository
  • GitHub 로그인 정보 또는 SSH 키
  • 하루에 10분씩 커밋 연습할 작은 파일

다음: Day 21 - Git 설치 (Windows)

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.