project-based-learning 딥다이브
— "강의를 보지 말고, 직접 만들면서 배워라" — 언어별로 정리된 '직접 만들기' 튜토리얼 대백과

practical-tutorials/project-based-learning. "바닥부터 직접 만들며 배우는(build from scratch)" 프로그래밍 튜토리얼을 프로그래밍 언어별로 모아 둔 거대한 큐레이션 목록이다. 데이터베이스·셸·OS·Git·인터프리터·Redis 클론 같은 "네 손으로 직접 만드는 X" 튜토리얼이 22개 언어 섹션에 약 450개 링크로 정리돼 있다. 실행되는 앱이 아니라 단 하나의 README.md가 상품인 awesome 리스트로, "수동적 강의 시청"이 아니라 "능동적 만들기"가 더 잘 배운다는 철학에 베팅한 레포다. (저장소: practical-tutorials/project-based-learning · 형식 Markdown 큐레이션 · 라이선스 MIT)

1프로젝트 한줄 요약

"이 레포 자체는 코드를 가르치지 않는다 — '무엇을 만들며 배울지'를 언어별로 안내하는 거대한 지도다."

이 저장소의 학습 콘텐츠는 README 링크 목록입니다. 별도의 튜토리얼 앱은 없지만 scripts/check_readme.py라는 실제 Python 검사 코드와 GitHub Actions가 있습니다. 문서 구조와 유지보수 자동화를 함께 읽어야 합니다.

2왜 주목받는가

"규모, 변치 않는 가치, 그리고 '만들며 배운다'는 강력한 철학 — 그래서 몇 년이 지나도 계속 트렌딩에 오른다."

먼저, '수동적 학습'의 함정

많은 입문자가 튜토리얼 영상·강의를 끝없이 봅니다. 보는 동안엔 다 아는 것 같지만, 막상 빈 에디터 앞에 앉으면 한 줄도 못 짜는 '튜토리얼 지옥(tutorial hell)'에 빠집니다. 지식이 '읽은 것'에 머물고 '해 본 것'이 되지 못했기 때문입니다.

숫자와 영향력

이 레포가 몇 년이 지나도 계속 트렌딩에 오르는 이유는, 내용이 '유행을 안 타는(evergreen)' 지식이기 때문입니다. "데이터베이스를 직접 만들어 보라"는 가치는 10년 전에도 지금도 유효합니다. 다만 외부 URL은 바뀌므로 현재는 정기 링크 검사와 수정 PR로 관리합니다. README가 "시작하려면 그냥 이 레포를 포크하세요"라고 안내해 입문자의 첫 포크·첫 PR 대상으로도 인기가 높습니다.

3기술 스택 — 문서와 유지보수 자동화

학습 목록은 Markdown이며 자동화는 Python 3 표준 라이브러리와 GitHub Actions로 구성됩니다. 과거의 Travis·Ruby awesome_bot 설명은 현재 tree와 다릅니다.

CONTRIBUTING.md는 무료·공개 접근, 완성 결과물이 있는 프로젝트 튜토리얼, 중복 검색, 작성자와의 관계 공개를 요구합니다. 단축 URL과 유료·로그인·뉴스레터 가입 장벽이 있는 자료는 기여 조건에 맞지 않습니다.

# 기여 가이드에 명시된 로컬 검사 예시
python3 scripts/check_readme.py lint

이 명령은 사용자가 기여할 때의 절차입니다. 이번 분석에서는 외부 저장소의 검사·네트워크 자동화를 실행하지 않고 코드를 읽었습니다. 워크플로 설정이 존재한다는 사실과 최근 실행 성공 여부도 구분합니다.

4아키텍처 — 목록은 어떻게 구성돼 있나

"최상위 구분은 '프로그래밍 언어별'. 큰 언어는 다시 주제·프레임워크로 가지를 친다."

전체 구조 한 장

책장을 언어별 칸으로 나눈 도서관을 떠올리면 됩니다. 최상위는 언어(##)로 나뉘고, 큰 언어는 다시 주제(###)로, JavaScript는 프레임워크(####)까지 가지를 칩니다.

실제 언어 섹션과 규모

항목의 '문법' — 목록의 한 줄은 어떻게 생겼나

# 단일 튜토리얼
- [Build Your Own Text Editor](https://...)   (제목+링크, 때로 (video) 태그)

# 다중 파트 시리즈는 부모-자식 들여쓰기
- Building Blockchain in Go
    - [Part 1](https://...)
    - [Part 2](https://...)
    ...

이렇게 일관된 한 줄 문법이 있어야 사람이 읽기 좋고, 동시에 check_readme.py의 공통 파서가 링크를 검사할 수 있습니다 — 구성과 자동화가 맞물려 돌아갑니다.

5디렉토리 구조 해부

project-based-learning/
├── README.md                     # 언어별 튜토리얼 목록, 676줄
├── CONTRIBUTING.md               # 기여 조건과 lint 절차
├── LICENSE.md
├── scripts/
│   ├── check_readme.py            # 공통 파서·lint·URL 검사·prune
│   ├── linkcheck-domains.txt      # 자동 접근 제한 도메인 정책
│   └── lint-allow-duplicates.txt  # 기존 중복 URL 예외
└── .github/
    ├── link-rot-state.json        # URL별 관측 상태
    ├── workflows/                # PR 검사·정기 검사·PR stale 관리
    └── ISSUE_TEMPLATE/           # 깨진 링크·자료 제안 양식

classify_line은 제목·단일 항목·시리즈·목차를 분류합니다. cmd_prune은 정확히 한 주요 항목과 대응되는 URL에 한정해 수정하고, 모호한 항목은 사람이 판단하도록 남깁니다. 문서 형식을 데이터 계약으로 만들면 lint와 정기 검사가 같은 해석을 공유할 수 있다는 점이 학습 포인트입니다.

6학습 포인트 (어떻게 활용하나)

"고르는 법은 셋 — 내 언어 섹션으로 가서, 관심 주제를 고르고, 다 만든 뒤 난이도를 올린다."

7시스템 요구사항

"레포 자체엔 요구사항이 거의 없다 — 브라우저, 그리고 고른 프로젝트의 언어 도구뿐."

8직접 해볼 수 있는 실습 과제

"작은 앱 → 풀스택 → CLI 도구 → 인터프리터 → DB → OS 순으로 난이도를 올려 보자."

9관련 기술 심화 학습 로드맵

"이 목록을 4주 코스로 쓰는 한 가지 방법."

10핵심 키워드 사전

"학습 방법론 + 큐레이션 레포 용어를 한자리에."

11참고 링크

"형제 격인 '직접 만들기' 자료들과 함께 보면 좋다."

• 저장소: github.com/practical-tutorials/project-based-learning
• README 원본: raw README.md
• 형제 격 "build your own X": codecrafters-io/build-your-own-x
• 핸즈온 "직접 만들기"(유료): codecrafters.io
• 기여 방법: 레포의 CONTRIBUTING.md(포크 → PR당 튜토리얼 하나 → 올바른 언어 섹션에 배치)