콘텐츠로 이동

위키 지식 연대기

이 페이지는 Swiftlang wiki의 지식 추가·확장 흐름을 별도로 기록하는 연대기다. 개별 지식 페이지는 주제 자체 설명에 집중하고, 위키의 확장 메타 정보는 여기로 모은다.

기록 원칙

  • 새 상위 허브, 대규모 문서 수집, 공식 문서 해설 묶음, proposal 교차 읽기 묶음처럼 지식 범위가 넓어지는 변화 위주로 기록한다.
  • lint, sanitize, 내부 정리 같은 유지보수 작업은 필요할 때만 최소한으로 언급한다.
  • 새 배치가 추가될 때마다 이 페이지도 함께 갱신한다.

2026-04-11

home / power-user 진입 구조 분리

홈 페이지를 처음 방문한 독자에게 더 가벼운 시작점으로 다듬고, 반복 방문자와 구현 중심 독자를 위한 별도 압축 인덱스가 추가됐다.

대표 페이지: - Swift Compiler Wiki - 파워유저 시작점

핵심 방향: - home은 시작 경로와 대표 허브 중심으로 slim down - 반복 방문자용 긴 링크 묶음은 power-user page로 분리 - 같은 세부 문서를 공유하되, 진입 경험만 분리

위키 원칙과 철학 명문화

위키를 단순 문서 저장소가 아니라 지식베이스로 유지하기 위한 기준 문서가 추가됐다.

대표 페이지: - 위키 원칙과 철학 - 위키 편집 체크리스트 - 위키 생성 템플릿 - 위키 taxonomy / frontmatter 규칙

핵심 방향: - subject page는 주제 자체 설명에 집중 - 위키 내부 메타/히스토리는 메타 페이지로 분리 - 새 지식은 허브/역링크/키워드 축과 함께 묶어서 추가 - 반복 가능한 좋은 작업은 스킬과 체크리스트로 승격

2026-04-10

상위 허브 확장

이날 위키는 개별 문서 모음에서 상위 지도와 학습 허브가 있는 구조로 크게 확장됐다.

추가/정비된 대표 허브: - Swift 전체 지도 - Swift 언어 개요 - Swift와 Swift Compiler의 관계 - Swift 타입 시스템 - Swift 소유권·메모리 모델 - Swift Concurrency 전체 구조 - Swift actor isolation·Sendable - Swift Task·Executor·Runtime - 표준 라이브러리·런타임·컴파일러의 관계 - Swift 툴체인 스택 - Swift 매크로·도구 스택 - Swift Compiler 학습 스택 - Swift Compiler 빌드·테스트·디버그 스택

공식 문서 / 다운로드 축 확장

공식 문서를 위키 안에서 다시 읽을 수 있도록 다운로드 허브와 해설 허브가 크게 보강됐다.

대표 페이지: - Swift 공식/준공식 참고 문서 다운로드 - 공식/다운로드 문서 해설 허브 - 언어 → 컴파일러 교차학습 지도 - Swift.org Documentation 허브 해설 - Swift Compiler 공개 개요 해설 - Compiling Swift Generics PDF 해설 - SIL.md 해설 - High-Level Optimizations in SIL 해설 - ABI Stability Manifesto 해설

동시성 / 입문 경로 확장

동시성 관련 현재 구현 설명과 입문 경로가 보강됐다.

대표 페이지: - Swift 6 데이터 경쟁 안전성 검사 - Swift 컴파일러 입문 7일 코스 - Swift Concurrency 전체 구조 - Swift actor isolation·Sendable - Swift Task·Executor·Runtime

설계 역사 / proposal 교차 읽기 축 확장

Swift 설계 문서를 현재 구현 문맥과 함께 읽을 수 있도록 history 허브와 crosswalk 묶음이 본격적으로 추가됐다.

대표 허브: - Swift Evolution / proposal history

추가된 주요 교차 읽기 페이지: - Value Semantics / COW proposals → ownership/runtime 교차 읽기 - In-Place Operations proposal → writeback / COW / optimizer-friendly API 교차 읽기 - Optimizer Effects / Unsupported Optimization Attributes proposals → SIL optimizer / function attributes 교차 읽기 - Declaration Type Checker proposal → 현대 Sema 교차 읽기 - Compilation Model / WMO proposals → driver 교차 읽기 - Enums / EnumStyle proposals → 타입 시스템 / API 표면 / 레이아웃 교차 읽기 - TypeState proposal → 초기화 / lifetime / ownership 경계 교차 읽기 - Option Sets proposal → importer / layout / value-type API 교차 읽기 - AttrC proposal → C export / bridging / importer 교차 읽기 - C pointer interop proposals → UnsafePointer 모델 교차 읽기 - ObjC interop proposal → importer / dispatch 교차 읽기 - Initialization / Accessors proposals → property model 교차 읽기 - Initializer Inheritance proposal → 현대 init 모델 교차 읽기 - Constructors / ClassConstruction proposals → 현대 init 모델 교차 읽기 - Remote Mirrors proposal → runtime/reflection 교차 읽기

2026-04-09

기반 문서군 구축

첫날에는 위키의 기본 뼈대를 이루는 핵심 문서들이 수집·정리됐다.

대표 페이지/묶음: - Swift 컴파일러 모노레포 개요 - 컴파일러 용어 사전 - SIL (Swift Intermediate Language) 및 SIL 관련 페이지들 - Swift 옵티마이저 설계 - 타입 체커 설계 및 구현 - Swift 런타임 - ABI: 심볼 맹글링, ABI: 타입 메타데이터, ABI: 타입 레이아웃, ABI: 호출 규약, ABI 안정성 - 소유권 매니페스토 - 제네릭 매니페스토 - 에러 처리 설계 - 동적 캐스팅 동작

제네릭 / interop / 패키지 / 기여 가이드 확장

기초 코어 위에 제네릭, interop, 주요 패키지, 기여 관련 문서가 붙기 시작했다.

대표 페이지: - Compiling Swift Generics - Generic Signatures - Substitution Maps - Archetypes - Conformances - Objective-C 상호운용 - C에서 Swift로의 이름 변환 - Swift의 C API 임포트 방식 - C++ 상호운용성 개요 - C++를 Swift에서 사용하기 - C++에서 Swift 호출하기 - swift-syntax - swift-driver (패키지) - Swift Package Manager - SourceKit-LSP - Swift 개발 환경 설정 - Swift 테스트 가이드 - 지속적 통합 (CI)

코드 구조 분석 페이지 추가

문서 기반 요약만이 아니라, 실제 Swift 소스 트리 구조를 바탕으로 한 코드 분석 페이지도 들어왔다.

대표 페이지: - SIL 옵티마이저 패스 카탈로그 - AST 노드 계층 구조 - SwiftCompilerSources (Swift-in-Swift)

같이 보면 좋은 페이지