DaleSchool

첫 저장소 만들기

입문15분

학습 목표

  • GitHub에서 저장소를 새로 만들 수 있다
  • README.md를 작성해 프로젝트를 소개할 수 있다
  • 저장소의 주요 화면 구성을 이해할 수 있다

저장소 만들기

GitHub에 로그인한 뒤 저장소를 만들어봅니다.

  1. 오른쪽 상단 + 버튼 → New repository 클릭
  2. 아래 설정을 입력합니다:

| 항목 | 값 | 설명 | | ----------------- | ----------------------- | -------------------------- | | Repository name | my-first-repo | 저장소 이름 (URL에 포함됨) | | Description | 나의 첫 GitHub 저장소 | 선택 사항, 간단한 소개 | | Public / Private | Public | 누구나 볼 수 있음 | | Add a README file | ✅ 체크 | 초기 파일 자동 생성 |

  1. Create repository 버튼 클릭

저장소가 만들어지면 github.com/본인username/my-first-repo 주소로 접근할 수 있습니다.

저장소 화면 둘러보기

저장소 페이지의 주요 탭을 알아봅니다.

| 탭 | 역할 | | ----------------- | --------------------------------- | | Code | 파일 목록과 내용 보기. 기본 화면. | | Issues | 버그 신고, 기능 요청, 할 일 관리 | | Pull requests | 변경 사항 검토 및 병합 요청 | | Actions | 자동화 워크플로우 (CI/CD) | | Settings | 저장소 이름, 권한, 삭제 등 관리 |

README.md 편집하기

README는 저장소에 접속하면 가장 먼저 보이는 문서입니다. 프로젝트의 "첫인상"입니다.

  1. README.md 파일 클릭
  2. 연필(✏️) 아이콘 클릭 (Edit this file)
  3. 내용을 수정합니다:
# 나의 첫 GitHub 저장소

GitHub 입문 강의를 수강하면서 만든 연습용 저장소입니다.

## 배운 것들

- GitHub 저장소 만들기
- README 작성하기
- 파일 커밋하기
  1. 오른쪽 상단 Commit changes 클릭
  2. 커밋 메시지 입력: docs: README 업데이트
  3. Commit changes 버튼으로 저장

"왜?" — README가 중요한 이유

README는 프로젝트를 처음 보는 사람에게 다음을 알려줍니다:

  • 이 프로젝트가 무엇인가?
  • 어떻게 사용하는가?
  • 어떻게 기여할 수 있는가?

오픈소스 프로젝트의 품질은 README에서 판가름 나는 경우가 많습니다. 좋은 README는 협업자를 불러모으고, 나쁜 README는 사람들을 돌려보냅니다.

Markdown이란?

README는 Markdown 형식으로 작성합니다. #은 제목, **굵게**, -은 목록 등 간단한 문법으로 예쁜 문서를 만들 수 있습니다.

# 제목 1

## 제목 2

**굵게** _기울임_

- 목록 항목 1
- 목록 항목 2

[링크 텍스트](https://example.com)

심화 학습

Public vs Private 저장소

Public: 전 세계 누구나 코드를 볼 수 있습니다. 오픈소스 프로젝트에 적합. 무료.

Private: 초대한 사람만 볼 수 있습니다. 회사 프로젝트, 개인 작업에 적합. 무료 계정도 Private 저장소를 무제한 만들 수 있습니다 (collaborator 수 제한 있음).

처음 배울 때는 Public으로 만들어도 괜찮습니다. 언제든지 Settings에서 바꿀 수 있습니다.

저장소 이름 규칙
  • 영문, 숫자, 하이픈(-), 언더스코어(_) 사용 가능
  • 공백은 자동으로 하이픈으로 변환됨
  • 대소문자 구분 없음 (URL에서는 소문자 권장)
  • 같은 계정에서 중복 이름 불가

좋은 이름 예시: my-portfolio, study-notes, daleschool-projects

  1. GitHub에서 my-first-repo 저장소를 만드세요 (Public, README 포함).
  2. README.md를 자신의 소개로 편집하고 커밋하세요.
  3. 저장소 주소(github.com/username/my-first-repo)를 확인하세요.

Q1. README.md 파일의 역할로 가장 적절한 것은?

  • A) 저장소의 비밀번호를 저장한다
  • B) 프로젝트를 소개하는 문서로, 저장소에 접속하면 가장 먼저 표시된다
  • C) 저장소의 코드를 자동으로 실행한다
  • D) 다른 저장소를 연결하는 링크 파일이다

참고 자료