검색 의도와 장애 상황을 먼저 설명합니다
사용자가 어떤 오류 메시지, 증상, 환경에서 이 페이지를 찾는지 먼저 밝힙니다. 제목만 바꾼 반복 페이지가 아니라, 문제마다 다른 영향 범위와 원인 후보를 드러내는 것을 목표로 합니다.
Editorial Policy
InfraTree 콘텐츠는 장애 대응 흐름을 설명할 수 있어야 공개합니다.
InfraTree는 단순한 문제 목록이 아니라, 인프라 운영자가 증상, 관찰 신호, 흔한 오진, 복구 방향을 차례로 생각할 수 있게 만드는 공개 학습 콘텐츠를 지향합니다.
Principles
작성 원칙
모든 공개 가이드와 대표 문제는 아래 원칙을 기준으로 검토합니다.
관찰 신호와 점검 순서를 제공합니다
단순한 정답보다 먼저 확인할 로그, 명령어, 체크리스트를 제공합니다. Kubernetes, Linux, Network, Security, CI/CD 영역별로 실제 운영자가 따라갈 수 있는 순서를 우선합니다.
흔한 오진과 안전한 복구 방향을 구분합니다
재시작, 전체 캐시 삭제, 무조건 롤백처럼 위험한 첫 조치를 피할 수 있도록 오진 포인트를 별도로 적습니다. 복구 방향은 영향 범위를 줄이는 순서로 설명합니다.
미완성 페이지는 색인 대상에서 제외합니다
로딩 문구만 있는 페이지, 연결 문제가 없는 허브, 본문이 부족한 문제는 검색 색인에서 제외하고 내부 탐색용으로만 둡니다. 공개 색인 페이지는 첫 HTML에서 본문을 바로 읽을 수 있어야 합니다.
Update
검수와 업데이트
콘텐츠는 운영 중 발견되는 검색어, 사용자 제출, 현장 메모, 문제 풀이 기록을 바탕으로 개선합니다.
검색 유입이 많거나 오진 가능성이 큰 주제는 장문 가이드로 확장합니다.
시나리오, 체크리스트, FAQ, 복구 포인트가 충분한 문제만 대표 색인 대상으로 둡니다.
현장 메모와 문제 제안은 공개 전 운영자가 검토하며, 필요한 경우 표현과 구조를 편집합니다.