편집 정책

주장의 출처

이 사이트의 기술적 주장은 여기서 직접 측정한 것이거나, 출처를 밝힌 자료에서 가져온 것입니다. 세 번째 분류는 없습니다. 측정한 주장은 실험 기록을 식별자로 참조하고, 가져온 주장은 그 주장이 나오는 자리에서 제조사 문서나 프로젝트 문서, 이슈 스레드로 연결합니다. 발행 전에 자동 검사가 실행되며, 둘 중 어느 것도 없이 수치를 적은 문단이 있으면 빌드를 실패시킵니다.

다섯 가지 검증 라벨

모든 글은 맨 위에 다섯 라벨 중 하나를 표시합니다. 색만으로 구분하지 않고 글자로 적기 때문에 흑백 화면에서도, 스크린 리더에서도 그대로 읽힙니다.

직접 실측

해당 글의 테스트 환경 항목에 적힌 하드웨어에서 직접 실행한 결과입니다. 실험 기록이 붙어 있지 않은 글은 이 라벨을 달 수 없습니다.

공식 출처

제조사나 프로젝트 문서에서 가져온 내용으로, 사용한 자리에 링크를 답니다.

추론

다른 구성에서 측정한 결과를 바탕으로 끌어낸 내용입니다. 어떤 구성이었는지, 그 구성이 달라지면 무엇이 영향을 받는지 글에 적습니다.

미실측

다른 사람이 보고한 내용을 재현 없이 옮긴 것입니다. 드물게만 쓰며, 글의 핵심 주장에는 쓰지 않습니다.

기록

운영자가 실행 당시에 적어 두고 나중에 다시 읽은 기록입니다. 그 실행은 반복하지 않았고, 시드와 버전은 당시에 남기지 않았으며, 여기 적힌 수치는 측정값이 아니라 기록입니다. 개발 일기 글에 이 라벨이 붙습니다.

측정값의 유효 기간

드라이버와 런타임, 모델 가중치는 자주 바뀌기 때문에 6개월 지난 측정값은 높은 쪽으로도 낮은 쪽으로도 틀릴 수 있습니다. 마지막 검증일이 90일을 넘은 글과 데이터베이스 레코드는 해당 페이지에 오래됨으로 표시합니다. 오래된 내용은 삭제하지도, 숨기지도 않습니다. 얼마나 오래된 것인지 독자가 볼 수 있다면, 날짜가 붙은 옛 수치가 답이 없는 것보다 낫습니다.

재검증은 현재 버전에서 측정을 다시 실행하고 검증일을 갱신하는 것입니다. 아무것도 다시 실행하지 않고 날짜만 고치는 것은 재검증이 아닙니다.

실패한 시도

오류를 다루는 글에는 문제를 해결한 구성만이 아니라 해결하지 못한 구성도 함께 적습니다. 독자는 이미 세 가지쯤 시도해 본 뒤에 들어오고, 막다른 길의 목록이 있어야 자기 상황을 빠르게 걸러낼 수 있습니다.

발행을 막는 검사

변경할 때마다 자동 검사 일곱 가지가 실행되고, 그중 하나라도 걸리면 발행되지 않습니다.

1. 글의 프런트매터가 정해진 스키마와 맞지 않는 경우.
2. 기술적 주장에 근거 식별자도 출처 링크도 없는 경우.
3. 실험 기록이 실험 JSON 스키마를 통과하지 못하는 경우.
4. 내부 링크가 끊어진 경우.
5. 초안 글이 사이트맵에 올라가는 경우.
6. 글의 최종 사람 검토 플래그가 설정되지 않은 경우.
7. 검토를 마친 뒤에 글의 본문이 바뀐 경우.

마지막 항목이 있어야 검토가 의미를 갖습니다. 플래그만으로는 검토가 있었다는 사실만 남고 이후의 모든 수정에도 그대로 유지되기 때문에, 이제 각 글에는 실제로 읽은 본문의 체크섬이 함께 붙습니다. 빌드할 때마다 현재 본문에서 체크섬을 다시 계산합니다. 단어 하나만 바뀌어도 체크섬이 맞지 않게 되고, 그 글은 다시 읽고 승인해야 발행할 수 있습니다. 이 방식을 도입하기 전에 발행한 글은 순차적으로 채워 넣고 있습니다.

여덟 번째 검사는 글 사이의 문단을 비교해 겹치는 부분이 있으면 경고합니다. 같은 실험을 여러 글에 얇게 나눠 쓰는 것을 잡아내기 위해서입니다.

이미지

스크린샷과 차트, 영상 프레임은 여기서 직접 실행한 결과로 만듭니다. 다른 사람의 영상이나 블로그 글, 방송에서 캡처한 화면은 라이선스가 어떻게 표시돼 있든 사용하지 않습니다.

독립성

어떤 제조사도 이 사이트의 글에 비용을 대거나, 발행 전에 글을 미리 보거나, 결론을 승인하지 않습니다. 특정 글에서 그 조건이 달라지면 해당 글의 맨 앞에 그 관계를 밝힙니다. 제휴 링크는 도입된 뒤에 제휴 고지에서 따로 다룹니다.