다층 해상도 문서

LOD 100 - 개념 설계 (Conceptual)
  대상: 초기 기획자, 투자자
  내용: 기본 형태, 크기, 위치
  예시: "이 위치에 20층 건물"
  정보량: 부피, 대략적 비용

LOD 200 - 기본 설계 (Schematic)
  대상: 디자이너, 초기 엔지니어
  내용: 대략적 수량, 크기, 형상
  예시: "철골 구조, 커튼월 외벽"
  정보량: 주요 시스템, 공간 관계

LOD 300 - 상세 설계 (Detailed Design)
  대상: 시공사, 전문 엔지니어
  내용: 정확한 치수, 위치, 방향
  예시: "H-beam 400x200, 3m 간격"
  정보량: 시공 가능 수준

LOD 350 - 시공 문서 (Construction Documentation)
  대상: 현장 시공팀
  내용: 인접 요소와의 간섭 체크
  예시: "배관이 보 관통, Ø150mm"
  정보량: 조립 순서, 연결 상세

LOD 400 - 제작 및 조립 (Fabrication)
  대상: 제조업체, 설치팀
  내용: 제작 가능한 모든 정보
  예시: "볼트 M16, 8개, 토크 120Nm"
  정보량: 제품 사양, 설치 매뉴얼

LOD 500 - 준공 (As-Built)
  대상: 시설 관리자, 유지보수팀
  내용: 실제 시공된 상태
  예시: "2024.03.15 설치, 제조번호 #12345"
  정보량: 유지보수 이력, 교체 주기

# RFC-XXXX: [제목]
 
## TL;DR (30초, 모든 독자)
- 문제: 한 문장
- 해결책: 한 문장
- 영향: 누구에게 어떤 변화
 
## Abstract (2분, 의사결정자)
200-300단어로 전체 제안 요약
- 배경 맥락
- 핵심 아이디어
- 예상 효과
 
## Motivation (5분, 관련 팀)
### 현재 문제
- 구체적 사례
- 정량적 데이터 (가능하면)
 
### 왜 지금인가
- 타이밍의 중요성
- 대안 검토 결과
 
## Proposed Solution (15분, 구현 팀)
### High-Level Design
- 아키텍처 다이어그램
- 주요 컴포넌트
- 데이터 흐름
 
### Detailed Design (30분+, 엔지니어)
- API 명세
- 데이터 스키마
- 알고리즘 상세
- 에러 처리
 
### Implementation Plan
- 단계별 롤아웃
- 마이그레이션 전략
- 롤백 계획
 
## Alternatives Considered (선택적 읽기)
각 대안의 장단점과 기각 이유
 
## Open Questions (지속적 업데이트)
아직 결정되지 않은 사항
 
## References
관련 문서, 코드, 논의 링크

RFC 2000: Const Generics

# Summary (1 paragraph)
Allow types to be parameterized by constant values.

# Motivation (2 pages)
- Current workarounds and their problems
- Use cases from real projects

# Guide-level explanation (5 pages)
- How users will use this feature
- Examples for common scenarios

# Reference-level explanation (10 pages)
- Precise semantics
- Interaction with other features
- Corner cases

# Drawbacks (1 page)
Why we might NOT want this

# Rationale and alternatives (3 pages)
Why this design over others

# Unresolved questions (living section)
What we'll figure out during implementation

Level 0: Pitch (1 페이지)
  대상: 잠재적 참가자, 펀딩 기관
  내용:
    - 한 문장 컨셉
    - 플레이 시간, 인원
    - 핵심 경험 ("무엇을 느낄 것인가")
  예시: "4시간, 8명, 가족의 비밀이 드러나는 저녁 식사"

Level 1: Design Document (10-20 페이지)
  대상: 다른 디자이너, 학술 연구자
  내용:
    - 디자인 의도와 철학
    - 핵심 메커니즘 설명
    - 영감 출처
    - 예상되는 플레이어 경험
  예시: "우리는 '침묵'을 메커니즘으로 사용한다..."

Level 2: Facilitator Guide (30-50 페이지)
  대상: 실제 LARP를 진행할 사람
  내용:
    - 사전 준비물 체크리스트
    - 워크샵 진행 방법
    - 타임라인과 개입 시점
    - 트러블슈팅 가이드
  예시: "만약 플레이어가 30분 동안 침묵하면..."

Level 3: Player Materials (각 5-10 페이지)
  대상: 실제 플레이어
  내용:
    - 캐릭터 배경 (알아야 할 것만)
    - 관계도
    - 개인 목표 (비밀)
    - 안전 도구 사용법
  예시: "당신은 어머니다. 당신만 아는 비밀은..."

Level 4: Post-Game Debrief Guide (5 페이지)
  대상: 진행자 + 플레이어
  내용:
    - 디브리핑 질문
    - 블리드(bleed) 관리
    - 추가 자료 링크
  예시: "오늘 경험에서 가장 힘들었던 순간은?"

1. One-line pitch (필수, 공개)
2. 200-word description (필수, 공개)
3. Content warnings (필수, 공개)
4. Detailed design doc (선택, 심사위원만)
5. Previous run feedback (선택, 심사위원만)

+ 구조화된 메타데이터:
  - 플레이어 수: 최소/최대
  - 물리적 강도: 1-5
  - 감정적 강도: 1-5
  - 사전 준비 필요: 예/아니오

Document Structure:

1. Page Summary (AI-generated, 3 bullets)
   - 핵심 개념 1
   - 핵심 개념 2
   - 핵심 개념 3

2. Introduction (필수 읽기)
   - 이 문서가 다루는 것
   - 이 문서가 다루지 않는 것
   - 사전 요구 지식
   - 예상 소요 시간

3. Quick Start (최소 경로)
   - 5분 안에 작동하는 예제
   - "Hello World" 수준
   - 다음 단계로의 링크

4. Concepts (선택적 깊이)
   ├─ Basic Concepts (모든 사용자)
   │  └─ [Expand] Advanced Concepts
   │     └─ [Expand] Edge Cases
   └─ [Expand] Theoretical Background

5. How-To Guides (작업 기반)
   - 일반적 작업 (상단)
   - 고급 작업 (하단, 접힌 상태)

6. Reference (검색용)
   - API 문서
   - 설정 옵션
   - 에러 코드

<!-- Expandable Sections -->
<details>
  <summary>Basic explanation (모든 사용자)</summary>
  <p>Detailed explanation (관심 있는 사용자만)</p>
 
  <details>
    <summary>Even more detail (전문가만)</summary>
    <p>Implementation specifics...</p>
  </details>
</details>
 
<!-- Tabbed Content -->
<tabs>
  <tab title="Beginner">간단한 예제</tab>
  <tab title="Intermediate">실전 예제</tab>
  <tab title="Advanced">최적화 기법</tab>
</tabs>
 
<!-- Conditional Display -->
<content for="role:developer">
  코드 레벨 설명
</content>
<content for="role:manager">
  비즈니스 영향 설명
</content>

GET /v1/customers

[Quick Example] (접힌 상태)
  curl https://api.stripe.com/v1/customers \
    -u sk_test_xxx:

[Parameters] (펼쳐진 상태)
  email (optional)
    - Type: string
    - [Show more] → Validation rules, examples

[Response] (접힌 상태)
  [Show example response]
  [Show response schema]

[Common Errors] (접힌 상태)
  [Show error handling guide]

[Try it in the Dashboard] (링크)

❌ 나쁜 예:
  Level 1: "자세한 내용은 Level 2 참조"
  → Level 1만 읽으면 아무것도 모름

✅ 좋은 예:
  Level 1: "X는 Y를 해결한다" (완결된 이해)
  Level 2: "X는 A, B, C 방식으로 Y를 해결한다" (더 깊은 이해)

각 레벨은 다음을 명시해야 함:
- "이 레벨을 읽어야 하는 사람": 역할, 목적
- "이 레벨에서 얻을 수 있는 것": 학습 목표
- "다음 레벨로 가야 하는 시점": 트리거 조건
- "이전 레벨로 돌아가는 방법": 네비게이션

같은 레벨 내에서는 추상화 수준 유지:

LOD 200 (기본 설계):
  ✅ "철골 구조"
  ✅ "커튼월 외벽"
  ❌ "H-beam 400x200" (너무 상세, LOD 300)
  ❌ "건물" (너무 추상, LOD 100)

독자는 순차적으로 읽지 않음:
- 목차에서 바로 점프
- 검색으로 특정 섹션 찾기
- 관련 섹션 간 링크
- "이 부분만 필요하면 X 섹션으로"

1. 가장 중요한 정보 먼저 (TL;DR)
2. 핵심 세부사항 (Abstract)
3. 배경과 맥락 (Motivation)
4. 완전한 상세 (Detailed Design)
5. 부가 정보 (Appendix)

각 주제를 여러 레벨로 반복:

주제: 인증 시스템
  Layer 1: "사용자 로그인 지원"
  Layer 2: "JWT 토큰 기반 인증"
  Layer 3: "RS256 알고리즘, 15분 만료"
  Layer 4: "토큰 갱신 로직, 블랙리스트 관리"

중심 문서 (Hub):
  - 전체 개요
  - 각 주제로의 링크

주변 문서 (Spokes):
  - 각 주제의 상세 내용
  - 독립적으로 읽기 가능
  - 다시 Hub로 돌아가는 링크

문제: Level 1에서 "빠르다"고 했는데 Level 3에서 "느릴 수 있음"
해결:
  - 자동화된 일관성 체크
  - 단일 소스에서 여러 뷰 생성
  - 정기적인 크로스 체크

❌ "자세한 내용은 매뉴얼 참조" (링크 없음)
❌ Level 1이 Level 2의 단순 요약 (독립적 가치 없음)
❌ 모든 내용을 접기/펼치기로 숨김 (발견 불가)
❌ 레벨 간 용어 불일치 (혼란 유발)

사용자 프로필에 따라 자동 조정:
- 초보자 → 더 많은 설명, 예제
- 전문가 → 핵심만, 레퍼런스 위주
- 역할별 → 관련 섹션만 하이라이트

- 슬라이더로 상세도 조절
- "5분 버전 보기" 버튼
- 읽은 시간 추적 및 추천

- 각 레벨을 다른 팀이 작성
- 자동 일관성 체크
- 버전 관리 및 변경 추적