2026. 1. 24. 01:52ㆍ타입스크립트로 함께하는 웹 풀 사이클 개발
[1일차] 포트폴리오 / 협업 환경 구성 (1)
25.12.30 · Part 1. 프로젝트 관리 ~ Part 2. 깃 처음 만나기
📋 오늘 다뤄본 것들
첫날은 개발 이전에 알아야 할 기본기부터 시작했다. 프로젝트가 무엇이고 Readme가 왜 필요한지 짚어본 뒤, Readme를 쓰기 위한 도구인 Markdown 문법을 익혔다. 오후에는 Git으로 넘어가 버전관리라는 개념과, 로컬·중앙집중식·분산 방식이 어떻게 다른지 비교하며 하루를 마무리했다.
🗂️ Part 1. 프로젝트 관리
프로젝트란 무엇인가
프로젝트는 일정한 기간 안에 일정한 목적을 달성하기 위해 수행하는 업무 묶음이다. 기획, 설계, 개발, 테스트, 배포까지 전 과정을 포함하는 개념이라, 협업이 많고 문서·코드 공유가 매우 중요하다는 걸 다시 짚었다.
리드미(Readme)의 두 얼굴
Readme는 상황에 따라 역할이 달라진다. 완성된 프로그램에서는 설명서 역할을, 구현 중인 프로젝트에서는 진행 상황 공유 역할을 한다.
Readme를 쓰는 도구, Markdown
.md 확장자를 쓰는 Markdown은 일반 유저도 웹에서 구조적이고 가시적으로, 가독성 좋게 텍스트를 변환해주는 문법이다. 읽기도 쉽고 쓰기도 쉬워야 한다는 게 핵심 원칙이며, Git·GitHub·위키백과·블로그·노션 등 폭넓게 쓰인다. 특히 GitHub에서는 협업을 이어주는 허브 역할을 한다.
Markdown 사용법
자주 쓰는 문법은 아래 표 정도만 기억해도 대부분의 문서를 작성할 수 있다.
| 문법 | 의미 | 예시 |
|---|---|---|
# ~ ###### |
제목 (1~6단계) | # 제목1 |
*텍스트* / **텍스트** |
기울임 / 굵게 | 기울임, 굵게 |
- 또는 * |
순서 없는 목록 | - 항목 |
1. |
순서 있는 목록 | 1. 항목 |
`코드` |
인라인 코드 | 코드 |
``` |
코드 블록 | 여러 줄 코드 감싸기 |
[텍스트](URL) |
링크 | [구글](google.com) |
 |
이미지 | 이미지 삽입 |
> |
인용문 | > 인용 |
--- |
구분선 | 가로줄 삽입 |
# 뒤에 반드시 띄어쓰기가 있어야 렌더링되고, 목록도 마커 뒤에 공백 하나가 필요하다. 이 두 가지만 기억해도 오타로 안 깨진다.Markdown 실습
정리한 문법을 직접 .md 파일에 적용해보며 헤더, 목록, 강조 표현이 실제로 어떻게 렌더링되는지 확인하는 실습을 진행했다.
GitHub Markdown
GitHub에서는 기본 Markdown을 일부 변형한 GFM(Github-Flavored Markdown)을 사용한다.
🗂️ Part 2. 깃 처음 만나기
버전이란?
버전은 유의미한 수정을 뜻한다. 수정과 백업을 위해서는 이 버전을 체계적으로 관리할 필요가 있고, 그래서 버전 관리가 필요해진다.
체계적인 버전 관리가 없으면 결국 이렇게 된다
버전관리 시스템(VCS)이 하는 일
Version Control System은 크게 세 가지 역할을 한다.
VCS 종류 비교
VCS는 저장 방식에 따라 로컬, 중앙집중식, 분산 세 가지로 나뉜다.
| 로컬 VCS | 중앙집중식 VCS | 분산 VCS | |
|---|---|---|---|
| 저장 위치 | 내 컴퓨터에서만 관리 | 중심 컴퓨터 한 곳에 저장 | 내 컴퓨터 + 다른 컴퓨터 모두에 저장 |
| 백업·복구 | 가능 | 가능 | 가능 |
| 협업 | 불가능 | 가능 (필요한 파일만 가져와 작업) | 가능 (프로젝트 자체를 가져와 작업) |
| 특징 | — | 각자 파일 수정 시 관리가 어려움 | 중앙집중식 대비 관리가 훨씬 편하고 안정적 |
| 대표 시스템 | — | SVN, CVS | Git, Mercurial, Bazaar |
✍️ 마치며
첫날은 코드보다 "왜 기록하고 왜 관리해야 하는가"를 먼저 짚은 하루였다. Readme와 Markdown이 협업의 언어라면, 버전관리는 그 협업을 안전하게 지탱하는 장치라는 게 오늘의 결론이다. 다음 시간부터는 이 개념을 바탕으로 실제 Git 명령어를 다뤄볼 예정이다.
🏷️ 프로젝트관리 | Git | GitHub | Markdown | Readme | 학습일지 | 데브코스
'타입스크립트로 함께하는 웹 풀 사이클 개발' 카테고리의 다른 글
| [풀스택] 260105월 - 포트폴리오 / 협업 환경 구성(3) (0) | 2026.07.02 |
|---|---|
| [풀스택] 251231수 - 포트폴리오 / 협업 환경 구성(2) (0) | 2026.07.02 |