기본 마크다운
markdown basic 테스트 목적 제목, 문단, 목록, 인용, 코드 블록 같은 기본 마크다운 요소가 깨지지 않고 렌더링되는지 확인합니다. 확인 항목 heading 계층이 자연스러운가 list와 blockquote가 본문 리듬을 해치지 않는가 inline code와 code block이 명확히 구분되는가 예시 이 인용은 본문과 같은 폭 안에서 읽혀야 합니다. ...
markdown basic 테스트 목적 제목, 문단, 목록, 인용, 코드 블록 같은 기본 마크다운 요소가 깨지지 않고 렌더링되는지 확인합니다. 확인 항목 heading 계층이 자연스러운가 list와 blockquote가 본문 리듬을 해치지 않는가 inline code와 code block이 명확히 구분되는가 예시 이 인용은 본문과 같은 폭 안에서 읽혀야 합니다. ...
long post 서론 긴 글은 문서의 체력을 보여 줍니다. 목차, 섹션 구조, 인용, 코드, 이미지, shortcode가 함께 붙을 때도 읽기 리듬이 유지되어야 합니다. 배경 이 글은 단순한 예제가 아니라 실제 운영 글처럼 보이도록 설계했습니다. 긴 글은 중간에 한 번 더 호흡을 정리해 주는 소제목이 필요합니다. ...
single page 테스트 목적 본문형 페이지는 제목, 설명, 메타, 목차, 본문 사이의 균형이 중요합니다. 정보가 너무 많으면 산만하고, 너무 적으면 구조가 사라집니다. 확인 항목 제목과 설명이 같은 계층에서 충돌하지 않는가 목차가 필요한 문서에만 적절히 나타나는가 본문 너비와 줄길이가 읽기 좋은가 기대 결과 독자는 이 페이지를 읽으며 구조를 바로 파악하고, 다음 페이지로 이동할 수 있어야 합니다. ...
design tokens 테스트 목적 토큰이 CSS, 템플릿, shortcode에서 같은 의미로 읽히는지 확인합니다. 숫자를 직접 박아 넣는 대신 토큰이 흐르는지 보는 테스트입니다. 확인 항목 기초 값과 의미 값이 구분되는가 컴포넌트가 직접 숫자를 들고 있지 않은가 토큰 변경이 여러 UI에 예측 가능하게 반영되는가 기대 결과 페이지 상단의 핵심 카드, 표, 본문 간격이 같은 시각 언어를 유지해야 합니다. ...
release checklist 점검 항목 content/ko의 경로가 모두 의도한 위치에 있는가 docs와 lab의 역할이 섞이지 않았는가 blog에 검증 전용 글이 들어가지 않았는가 기본 taxonomy와 menu가 연결되는가 TOML front matter가 모두 유효한가 모바일 화면에서 주요 페이지가 깨지지 않는가 릴리스 기준 모든 필수 항목이 통과해야 릴리스 가능합니다. 하나라도 불명확하면 그 항목은 다시 문서화해야 합니다. ...
menus 테스트 목적 메뉴는 content가 아니라 구성 파일에서 관리해야 합니다. 이 페이지는 메뉴 구조를 이해하고, 바뀌어도 어디를 먼저 수정해야 하는지 확인하는 기준입니다. ...
motion shape 테스트 목적 모션과 형태는 거의 보이지 않지만 인상을 크게 바꿉니다. 과한 motion은 장식이 되고, 너무 적은 shape는 페이지를 딱딱하게 만듭니다. 확인 항목 hover와 focus 상태가 구분되는가 radius가 카드와 버튼에 같은 문법으로 적용되는가 transition이 빠르되 거슬리지 않는가 기대 결과 레이어는 분명해야 하지만 과장되면 안 됩니다. 부드러우면서도 단정한 느낌이 목표입니다. ...
badges 테스트 목적 배지는 메인 정보가 아니라 보조 신호입니다. 상태, 분류, 짧은 메타가 본문을 가리지 않는지 확인합니다. 확인 항목 짧은 라벨이 적절한 밀도로 보이는가 배지가 줄바꿈될 때 디자인이 깨지지 않는가 색이 정보의 주인공이 되지 않는가 기대 결과 배지는 시선을 빼앗지 않으면서도 맥락을 보강해야 합니다. ...
buttons 테스트 목적 버튼은 사용자의 행동을 유도하는 가장 중요한 상호작용 요소입니다. primary, secondary, external, utility가 같은 시스템 안에서 분리되어 보여야 합니다. 확인 항목 primary 버튼이 가장 먼저 읽히는가 secondary 버튼이 보조 행동으로 인식되는가 external 행동이 내부 이동과 헷갈리지 않는가 긴 라벨이 줄바꿈되어도 버튼 구조가 유지되는가 shortcode 예시 구조 확인 시작 ...
breadcrumbs 테스트 목적 breadcrumb는 사용자가 지금 어디에 있는지, 어디에서 왔는지 설명합니다. 깊은 구조일수록 중요합니다. 확인 항목 상위 계층이 올바르게 나열되는가 현재 페이지가 마지막에 분명히 표시되는가 모바일에서 길이가 과도하지 않은가 기대 결과 breadcrumb는 현재 문맥을 잃지 않게 해 주는 작은 나침반입니다. ...