블로그

figures 테스트 목적 figure는 이미지를 설명하고 본문에 다시 연결하는 역할을 합니다. 그림이 있더라도 본문이 끊기지 않아야 합니다. 예시 구조 다이어그램이미지와 캡션이 본문 의미를 보강해야 합니다. ...

built-in shortcodes 테스트 목적 Hugo 기본 shortcode는 문서 구조와 별개로 동작해야 합니다. figure, details, raw HTML, embed 계열이 본문 안에서 안전하게 렌더링되는지 봅니다. 예시 figure 예시이미지 shortcode가 본문 레이아웃을 깨지 않아야 합니다. ...

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 테스트 목적 배지는 메인 정보가 아니라 보조 신호입니다. 상태, 분류, 짧은 메타가 본문을 가리지 않는지 확인합니다. 확인 항목 짧은 라벨이 적절한 밀도로 보이는가 배지가 줄바꿈될 때 디자인이 깨지지 않는가 색이 정보의 주인공이 되지 않는가 기대 결과 배지는 시선을 빼앗지 않으면서도 맥락을 보강해야 합니다. ...