메커니즘 애니메이션 (mechanism-animation)
「어떻게 동작하는지」를 한 페이지 분할 애니메이션으로 만듭니다: 독자가 스크롤할 때마다 한 단계씩 진행되며, 각 단계는 하나의 내용만 설명하고, 그림 속 요소들은 인과 순서에 따라 하나씩 나타나고, 이동하고, 사라집니다.
완성된 예시: assets/template.html – 템플릿, 자체 4단계 예제 포함 (캐시 없음 → 캐시 계층 추가). 브라우저에서 직접 열어서 확인 가능.
0. 먼저 판단: 애니메이션을 만들어야 하는가?
저렴한 것부터 비싼 것 순으로 시도하고, 이전 단계로 충분히 설명되면 다음 단계로 넘어가지 않습니다:
| 단계 | 사용 방법 | 언제 충분한가 |
|---|---|---|
| 1 | 그냥 글쓰기 | 두세 문장으로 설명 가능 |
| 2 | 번호 단계 (1. 2. 3.) | 과정이지만 각 단계가 한 문장으로 설명되고, 독자가 「볼」 필요가 없음 |
| 3 | 번호 단계 + 2–3장의 고정 이미지 (전/후 비교) | 구조, 관계; 또는 과정을 두세 장의 고정 이미지로 이해 가능 |
| 4 | 본 스킬: 분할 애니메이션 | 설명하는 것이 무엇이 어디로 가는지, 순서, 동일 데이터를 누가 공유하는지, 어떤 단계에서 무엇이 생략되었는지, 세 장의 고정 이미지로도 설명이 부족한 경우 |
판단 기준 한 문장: 그림을 임의의 프레임에 고정했을 때 독자가 이해할 수 있으면 ⇒ 정적 이미지로 충분; 「움직임」을 봐야 이해하면 ⇒ 애니메이션 제작.
두 가지 경계:
- 비용. 애니메이션은 정적 이미지보다 몇 배 더 비쌉니다 (사실 확인, 순서 배치, 시간 조정, 자체 테스트, 수정). 다른 사람이 애니메이션을 요구하지 않은 경우, 먼저 제안하고 왜 이전 세 단계로 부족한지 설명한 후 상대방이 동의하면 제작; 기본적으로 작업을 시작하지 마십시오.
- 애니메이션은 「처음 이해」만 담당하며, 참고 자료로 사용할 수 없음: 훑어보기 불가, 검색 불가, 문서에 삽입 불가. 따라서 페이지 끝에는 「전체 과정 한눈에 보기」가 있어야 합니다 (템플릿이 자동 생성: 각 단계 한 줄); 원본 문서는 텍스트 버전을 유지하고, 애니메이션 페이지로 연결되는 링크를 추가하되, 애니메이션 페이지로 문서를 대체하지 마십시오.
1. 프로세스
- 사실 확인. 애니메이션은 오류를 생생하게 전달합니다. 그리기 전에 설명할 메커니즘을 코드 / 설계 문서 / 논문과 대조하여 확인하고, 「설계상 이렇게 말한다」「코드가 현재 이렇게 한다」「다른 곳(논문, 기본값)에서는 이렇게 한다」를 구분합니다. 확실하지 않은 경우 「추정, 실제 측정 필요」라고 적습니다.
- 스토리보드 작성 (코드 작성하지 않음).
references/storyboard.md를 참고하여 표를 작성: 각 단계 한 줄, 이 단계에서 설명할 한 가지 내용, 화면에 순서대로 나타나는 것 / 움직이는 것, 끝날 때 남는 것, 왼쪽 텍스트를 명확히 적습니다. 스토리보드가 아래 제2절의 설명 규칙을 통과한 후에 작업을 시작합니다. 단계가 많거나 (> 6단계) 설명 방식에 확신이 없는 경우, 먼저 요청자와 확인: 표만 보내고 그가 결정해야 할 질문 하나만 보내고, 문서 형태로 보내지 마십시오; 상대방이 결과물을 바로 보는 것을 선호하면 바로 제작합니다. - 템플릿에서 시작:
cp assets/template.html <결과물 디렉토리>/<이름>.html. 세 곳만 수정:- HTML의
<title>, 시작 페이지 (#top), 그림의aria-label, 끝 페이지 (#where, 바닥글의 「업데이트: 년월 · 어떤 버전을 기준으로 확인했는지」 포함) – 템플릿에서 이 부분들은 여전히 예제 내용이므로 각각 교체; - 스크립트 A 섹션:
PAGE,MODULES(모듈, 단계, 텍스트, 각 단계 지속 시간); - 스크립트 C 섹션: 화면 (어떤 객체, 각 단계에서 어떻게 움직이는지).
B1 / B2 두 섹션은 엔진이며 일반적으로 수정하지 않습니다. 작성 방법, 작은 도구, 기존 패턴은
references/engine.md를 참조하십시오.
- HTML의
- 자체 테스트:
node scripts/check.js <페이지.html> <스크린샷 디렉토리>, 10개 항목에서 FAIL이 없어야 함 (contain이 페이지에 소속 표시가 없으면 SKIP, 정상), 그런 다음 스크린샷을 하나씩 확인:step-NN(각 단계 끝),mid-NN(각 단계 중간),page-NN(전체 페이지). 스크립트는 「멈췄는지, 글자가 눌렸는지, 프레임 밖으로 나갔는지, 글자 크기가 충분한지」만 확인할 수 있고, 「설명이 잘 되었는지」는 확인할 수 없습니다. 4단계 페이지는 약 1분, 12단계는 약 3분 소요, 종속성 설치 및 사용법은 engine.md 끝 부분 참조. 4.5 (단계가 많거나 비전문가 대상일 때) 「처음 보는 사람」 테스트: 이 메커니즘을 모르고 어떤 자료도 읽지 않은 하위 에이전트를 시작하고, 페이지 각 단계의 스크린샷만 제공하여 순서대로 보고, 기억에 의존하여 각 단계에서 설명한 내용, 그림이 알려준 것인지 텍스트가 알려준 것인지, 이해하지 못한 부분을 설명하도록 합니다. 이해하지 못한 부분은 페이지의 문제이지 에이전트의 문제가 아닙니다 – 스스로 열 번 더 보는 것보다 효과적입니다. - 인도: 페이지 (단일 HTML, 다른 파일에 의존하지 않음)를 요청자에게 전달합니다. 이후 수정할 때마다 자체 테스트를 다시 실행한 후 전달합니다.
- (내용이 중요한 경우) 기술 검증: 페이지가 확정된 후, 읽기 전용 검증을 시작하여 페이지의 모든 문장과 숫자를 코드와 문서와 대조하여 하나씩 확인하고, 「잘못된 / 오해의 소지가 있는 / 부정확한」 목록을 작성하여 요청자가 수정할 항목을 결정하도록 합니다. 검증은 사실만 담당하며, 설명 방식의 품질은 요청자가 직접 확인합니다.
2. 설명 규칙 (가장 중요, 모두 반려된 후에 배운 것)
순서
- 쉬운 것부터 어려운 것, 「문제 없는 상황」부터 「문제가 있는 상황」 으로. 독자가 먼저 정상적인 모습을 본 후에야 문제가 무엇인지 알 수 있습니다. 예: 먼저 한 대의 가상 머신에서 많은 컨테이너가 메모리를 공유하는 것 (문제 없음), 그런 다음 여러 대의 가상 머신으로 변경되어 각각 하나씩 저장하는 것 (문제), 마지막으로 해결 방법.
- 하위 계층부터 상위 계층으로, 계층별로 나타나기. 먼저 호스트만 있음 → 데이터가 디스크에서 호스트 메모리로 → 가상 머신 등장 → 데이터가 가상 머신으로 → 마지막으로 내부 프로그램 등장. 처음부터 모든 상자를 배치하지 말고, 프로그램이 먼저 나타나고 데이터가 나중에 도착하지 않도록 합니다.
- 한 단계 내 여러 사건에 인과 관계가 있으면 순서대로 배치, 동시에 발생하지 않도록 합니다. 「컨테이너 종료」 후, 「메모리 비워짐」, 그 다음 「호스트로 반환」.
- 그림은 스크롤이 멈춘 후에 나타나며, 첫 번째 단계의 애니메이션은 처음부터 재생됩니다. 템플릿에서 이미 처리되었으므로 변경하지 마십시오.
각 단계에서 설명할 내용
- 한 단계에서는 한 가지 내용만 설명, 제목은 그 내용이어야 함 (「세 페이지가 각각 한 번 읽음」), 명사가 아님 (「읽기 단계」).
- 주요 라인은 실제 동작만 보여줌. 기본값, 다른 회사의 방식, 이전 방식은 이 단계의 요점에서 「왜 특별히 이렇게 하는지」 한 문장으로 언급하고, 별도의 단계로 만들지 마십시오 – 그렇지 않으면 독자가 실제로도 그 단계를 먼저 거쳐야 한다고 생각할 수 있습니다. (반례: 먼저 「2MB로 보고」를 보여주고 나서 「4KB로 보고」를 보여주면, 독자는 「2MB는 어디서 나온 거지? 실제로는 어떤 순서지?」라고 물을 수 있습니다.)
- 비슷해 보이는 두 단계는 독자가 같은 내용으로 간주. 두 시나리오에 차이가 있으면 차이를 그림으로 표현하십시오 (여러 화살표가 동일한 데이터로 모이거나, 공유되는 부분을 원으로 표시), 텍스트로만 설명하지 마십시오.
- 그림에 나타나는 모든 숫자와 단어는 출처가 있어야 함. 이전에 언급되지 않은 숫자 (「18」「2MB」)는 독자를 막히게 합니다; 출처를 밝히거나 삭제하십시오.
- 문제가 특정 방식에만 해당하는 경우, 해당 방식의 모듈에 배치하고, 총론에 배치하여 독자가 모든 방식에 해당 문제가 있다고 오해하지 않도록 하십시오.
- 독자가 아는 구체적인 예시를 사용하고, 추상적인 기호는 사용하지 마십시오. 몇 개의 선, 점, 짧은 막대가 움직이는 것을 독자는 무엇인지 알 수 없습니다 (독자 원문: 「그 4개의 진행 막대… 무슨 뜻인지 모르겠어요」). 설명할 수 있는 일로 바꾸십시오: 누가, 누구에게, 무슨 말을 했는지 (「결제 시스템」의 Agent가 「데이터 플랫폼」의 Agent에게 「주문 인터페이스는 어떻게 호출하나요?」라고 묻고, 상대방이 「인터페이스 문서를 보냈습니다」라고 응답); 기호를 사용해야 한다면 독자가 이전에 이미 본 것을 사용하십시오 (방금 목록에 있던 그 행들), 임시로 새로 만들지 마십시오. 하나의 예시를 철저히 설명하는 것이 세 쌍의 추상적인 왕래보다 낫습니다; 예시가 좋으면 다른 예시를 하나 더 추가하고, 같은 예시를 세 번 반복하지 마십시오.
- 이 단계에서 사용되지 않는 계층과 객체는 그리지 마십시오. 「계층별로 나타나기」가 모든 계층이 나타나야 한다는 뜻은 아닙니다: 「컨테이너가 가상 머신에 메모리를 반환」을 설명할 때 호스트를 그리면 독자는 계층을 하나 더 인식해야 하지만 아무것도 더 이해하지 못합니다 (독자 원문: 「호스트를 다시 표현할 필요는 없어요, 너무 복잡해요」). 그리기 전에 질문하십시오: 그것을 제거해도 이 단계의 문장이 여전히 성립합니까? 성립하면 제거하십시오.
- 설명 후에는 「그래서 어쩌라고」에 답해야 함. 각 모듈의 마지막 단계 또는 끝 페이지에 명시: 이것이 독자에게 의미하는 바, 현재 어디까지 진행되었는지 (이미 출시 / 테스트 환경에서만 / 아직 구현되지 않음).
- 깊이는 독자에 따라 결정. 작업을 시작하기 전에 「독자는 누구인가, 이미 무엇을 알고 있는가, 무엇에 관심이 없는가」를 적으십시오: 전문가에게 기초를 설명하면 장황하다고 느끼고, 비전문가에게 구현 세부 사항을 나열하면 너무 구체적이라고 느낍니다.
텍스트
- 각 단계: 한 문장 (lead) + 최대 2–3개 요점, 굵게는 결론적인 숫자나 단어에만 사용하십시오. 왼쪽 텍스트가 너무 많으면 세부 사항을 삭제하고, 세부 사항은 끝 페이지나 그림 오른쪽 아래의 작은 주석에 넣으십시오.
- 나중에 설명할 내용을 인용하지 마십시오. 「더 이상 각자 저장하지 않음」「여전히」「또한 같음」「그 부분」과 같은 말은 가리키는 것이 이전에 이미 등장했어야 합니다. 장 순서를 조정한 후, 앞으로 이동한 텍스트를 새로운 순서대로 처음부터 다시 읽으십시오.
- 처음 등장하는 용어는 즉시 반 문장으로 설명하고, 전체 페이지에서 동일한 것을 하나의 명칭으로만 사용하십시오.
- 페이지에 내부 이름을 표시하지 마십시오: RFC 번호, PR 번호, 파일 이름, 함수 이름, 명령어 이름, 내부 머신 이름. 단, 독자가 이 코드의 개발자인 경우는 예외입니다.
- 용어와 「숫자 + 단위」는 줄바꿈하지 마십시오: 텍스트에서
{{ }}로 감싸십시오. 예:{{4 KB}},{{1,380억 token}}. - 바닥글에 「업데이트: 년월 · 어떤 버전의 코드를 기준으로 확인했는지」를 표시. 페이지는 해당 날짜의 스냅샷이며, 코드는 변경될 수 있습니다.
- 추정 또는 실제 측정되지 않은 것은 「추정」「실제 측정 필요」라고 명시하고, 다른 회사의 숫자는 누구의 것인지 명확히 하십시오 (「논문」「POC」「main 브랜치에서」).
화면
- 동일한 것은 전체 과정에서 동일한 객체로 유지: 데이터 블록이 디스크에서 메모리로 「날아가고」, 다시 가상 머신으로 「날아가는」 것이지, 여기서 사라지고 저기서 나타나지 않습니다. 독자는 그것을 통해 과정을 따라갑니다.
- 색상은 고정된 의미를 가지며, 전체 페이지에서 일관되어야 함 (예: 청록 = 데이터, 보라 = 프로그램, 주황 = 현재 발생 중인 동작, 파랑 = 결론 / 반환된 것). 범례는 사용된 것만 표시하십시오.
- 동작도 고정된 의미를 가지며, 전체 페이지에서 사용법을 변경하지 않음 (예: 주황색 선 긋기 = 요청 보내기, 색상 블록 날아가기 = 데이터 전달, 주황색 원 = 모두가 공유하는 것, 전체 그룹 희미해지기 = 더 이상 사용되지 않음). 같은 유형의 동작은 속도가 일관되어야 함: 거리가 먼 것은 오래 날아가고, 모두 같은 시간으로 압축하지 마십시오.
- 상태는 색상으로 말하고, 두세 가지만 사용: 예: 「파랑 = 사용 중, 회색 = 해제됨」. 독자는 한눈에 파랑이 몇 개, 회색이 몇 개인지 셀 수 있어야 하며, 나중에「회색이 수거됨」을 이해할 수 있습니다; 같은 상태를 색상, 아이콘, 텍스트로 각각 설명하지 마십시오.
- 읽어야 할 글자는 움직이지 않음: 문장을 A에서 B로 전송해야 한다면, 이 문장을 말하는 쪽 옆에 고정하고, 선을 따라 작은 표식을 보내십시오; 독자는 고정된 글자를 읽고, 표식이 가는 길을 봅니다. 글자가 따라 날아가면 독자는 둘 다 보지 못합니다.
- 먼저 움직이고, 그 다음 멈춤: 단계의 주요 동작은 처음 60% 시간 내에 완료되고, 그 후 화면은 조용히 유지되어 독자가 왼쪽 문장을 읽을 시간을 줍니다; 두 개의 중요한 동작은 동시에 발생하지 않으며, 큰 이동은 0.5초 이상, 전체 그림을 가로지르는 것은 0.7초 이상이어야 하며, 너무 빠르면 눈이 따라잡을 수 없습니다.
- 온 길로 간다: 선으로 그린 상자는 퇴장 시 선으로 수거하고, 날아온 것은 날아갑니다. 전체 페이지의 출입은 두세 가지 수법만 사용하고, 페이드 인/아웃을 기본값으로 하지 마십시오.
- 여러 선이 동일한 목표로 모일 때는 다른 방향에서 진입 (왼쪽 끝, 위쪽 끝, 오른쪽 끝 각각 하나), 같은 가장자리에 나란히 배치하지 마십시오: 결국 겹치거나 다른 도형 뒤로 지나갈 수 있습니다 (독자 원문: 「휴대폰 선과 클라이언트 선이 겹치고, 휴대폰이 클라이언트 선을 가렸어요」).
- 의미는 맞지만 보기 좋지 않으면 아직 완료되지 않은 것 (독자가 구름에 대해 한 말: 「의미는 맞는데, 구름이 너무 못생기고 어색해요」). 핵심 도형 (전체 페이지에 반복해서 등장하거나 마지막 단계에서 사용되는 것)은 먼저 두세 가지 모양을 나란히 그리고 하나를 선택하십시오; 선택할 때 질문하십시오: 선이 페이지의 다른 것들과 같은 느낌인가요? 비율이 편안한가요? 배경 선과 구분이 잘 되나요?
- 강조 표시 (원, 화살표, 주황색 작은 글자)는 설명할 때 나타나고, 설명이 끝나면 퇴장하며, 늦어도 다음 단계 시작 시에 퇴장하고, 이후 단계로 가져가지 않습니다. 각 단계가 끝날 때의 화면은 별도로 봐도 설명이 되어야 함 (
step-NN.png가 이 화면입니다). - 공유/동일함 강조: 여러 화살표가 하나로 모여 동일한 목표에 도달하고, 주황색 원을 추가합니다.
- 「생략됨」「반환됨」은 동작으로 보여주어야 함: 물체가 점유 막대의 해당 부분으로 날아가고, 착지한 후 그 부분이 줄어듭니다; 날아가는 동안 줄어들지 않도록 합니다. 날아간 위치는 줄어든 부분과 일치해야 합니다.
- 개념도와 실제 크기가 일치하지 않을 때는 「개념도」라고 표시하고, 개념도의 그리드 크기가 존재하지 않는 단위를 암시하지 않도록 합니다.
- 상자의 중첩과 이름은 실제 소속을 따름: 작업을 시작하기 전에 「객체 → 실제 네트워크 공간/컨테이너/프로세스/서비스」 표를 작성하십시오. 독립적인 컨테이너 또는 프로세스 (사이드카, 프록시)는 나란히 상자로 그리고, 비즈니스 컨테이너 안에 그리지 마십시오; 외부 상자에는 그것이 무엇인지 명확히 적고 (「특정 컨테이너 그룹의 네트워크 공간」), 상자 이름은 독자가 아는 명칭을 사용하십시오 (「비즈니스 컨테이너」, 「메인 컨테이너」가 아님); 같은 이름의 것은 소속을 구분하십시오 (두 서비스에 각각 sidecar라는 구성 요소가 있을 때 각각 고정된 전체 이름을 사용), 그림과 왼쪽 패널에서 혼용하지 마십시오.
- 선의 꺾임은 최소화: 끝점은 두 상자의 마주보는 가장자리에 위치하고, 상자 중심을 조준하지 마십시오; 두 상자의 높이가 겹치면 직선 하나; 꺾어야 한다면 명확한 꺾임점 하나만 사용 (장애물을 피하는 U자형은 최대 두 개), 꺾임점은 텍스트를 피하십시오; 데이터 패킷, 빨간 선 등 같은 경로를 사용하는 것들은 이 꺾임점을 공유하십시오. 작은 꺾임은 독자가 「여기에 특별한 의미가 있다」고 생각할 수 있습니다.
check.js의bends항목이 차단합니다. - 설명 작은 글자는 상자 가장자리에 붙이고, 상자 안의 객체 위에 올리지 마십시오.
- 그림 속 글자는 14 캔버스 단위 이상이어야 함. 그림은 13인치 노트북에서 약 0.8배로 축소되며, 그보다 작으면 읽기 어렵습니다;
check.js의fontsize항목은 1280×720에서 11px 이하를 차단합니다. 들어가지 않으면 내용을 삭제하고, 글자를 줄이지 마십시오. 템플릿에는 별도의「확대 그림」(상단 버튼 / F 키)이 있으며, 이는 독자를 위한 옵션이지 글자가 작은 것에 대한 보완이 아닙니다.
3. 자주 발생하는 재작업 (이런 피드백을 받으면 이렇게 수정)
| 피드백 | 주된 원인 | 수정 방법 |
|---|---|---|
| 「이 단계 애니메이션이 끝나지 않았어요 / 끝 부분이 문제예요」 | 키프레임이 이 단계 종료 후에 배치되었거나, 페이드 인이 종료 시점에 딱 맞춰짐 | 이 단계의 모든 동작을 T(id, 0.88) 전에 시작하고, T(id, 1) 전에 멈춤; check.js의 still 항목이 보고함 |
| 「글자가 상자 밖으로 나갔어요 / 위치가 잘못됐어요」 | 부모 상자와 그 안의 내용이 같은 시간에 움직이기 시작하지 않음; 색상만 변경하는 키프레임을 하나 더 작성하여 위치를 고정시킴 | 부모와 자식이 같은 시간 세트를 사용; data-box / data-in 속성을 지정하고, contain 항목으로 프레임별 확인. 다른 지표 (글꼴 크기, 투명도)를 「상자 안에 있는지」 대신 사용하지 마십시오 |
| 「N번째 단계와 M번째 단계가 같아 보여요」 | 차이가 텍스트로만 작성됨 | 차이를 그림으로 표현 (위 참조: 화살표 모음 + 원) |
| 「X는 어디서 나온 거예요?」 | 그림에 설명되지 않은 숫자/단위가 있음 | 출처를 밝히거나 그림에서 제거하고, 「이유」에서만 한 마디 언급 |
| 「순서가 잘못됐어요, A 다음에 B여야 해요」 | 인과/계층 순서로 배치되지 않음 | 「하위 계층에서 상위 계층으로」에 따라 이 단계의 타이밍 재배치; 다른 단계도 동일한 기준으로 함께 확인 |
| 「XX가 이상해요, 이전에 언급된 적이 없어요」 | 텍스트가 나중에 설명할 내용을 인용함 | grep 「더 이상, 각자, 여전히, 또한 같음, 그 부분, 대비」를 사용하여 각각 가리키는 것이 이미 등장했는지 확인 |
| 「글자가 너무 많아요 / 안 보여요 / 너무 작아요」 | 세부 사항이 왼쪽 패널에 쌓임; 그림 속 글자가 14 미만 | 한 문장 + 요점으로 줄임; 그림 속 글자를 14 이상으로 조정하고, 들어가지 않으면 삭제; check.js의 fontsize, text 항목이 보고함 |
| 「홈페이지에서 스크롤 내리면 첫 번째 단계에 애니메이션이 없어요 / 새로고침 후 애니메이션이 없어요」 | 엔진의 진입 로직을 잘못 수정함 | B2 섹션의 enteredFirst, pendingShow, 시작 부분을 수정하지 마십시오; check.js의 wheel 항목이 보고함 |
| 「왜 이런 꺾임이 있나요?」(스크린샷 첨부) | 화살표가 상대방 상자의 중심을 조준하거나, 꺾임점이 각각 달라서 작은 왕복 꺾임이 발생; 같은 경로의 데이터 패킷과 선이 각자 다니게 됨 | 끝점을 마주보는 가장자리에 배치하고, 직선이 가능하면 직선으로, 최대 한 개의 꺾임점, 데이터 패킷과 선이 꺾임점 공유; check.js의 bends 항목이 보고함. 전체 그림의 모든 선을 동일한 기준으로 확인 |
| 「X는 독립적인 Y인가요? Z 안에 그리는 것이 적절한가요?」「이 부분은 …라고 불러야 더 정확하지 않나요?」 | 상자 중첩이 실제 소속을 따르지 않음 (사이드카를 비즈니스 컨테이너 안에 그림), 또는 상자 이름이 내부 명칭을 사용함 | 먼저 「객체 → 실제 소속」 표를 작성한 후 중첩을 수정; 외부 상자에는 그것이 무엇인지 명확히 적고, 상자 이름을 독자가 아는 명칭으로 변경; 유사한 상자는 전체 그림에서 함께 확인 |
피드백을 받으면, 먼저 이 피드백이 다른 단계에서도 해당되는지 생각하고 함께 수정하십시오. 상대방이 하나씩 지적할 때까지 기다리지 마십시오.
4. 파일
| 파일 | 내용 |
|---|---|
assets/template.html | 템플릿 (엔진 + 4단계 예제) |
scripts/check.js | 자체 테스트 스크립트 (10개 항목 + 스크린샷) |
references/storyboard.md | 스토리보드 작성 방법, 실제 12단계 스토리보드 |
references/engine.md | 템플릿 구조, 작은 도구, 화면 패턴, 함정, 자체 테스트 실행 방법 |
references/lessons.md | 몇 개의 완성된 페이지에서 얻은 피드백 기록 (규칙의 출처); 규칙이 다루지 않는 상황이 발생하면 여기서 가장 유사한 것을 찾음 |