5.2.1 사실

기술 블로그 글에 기술적인 세부 정보가 부족하다면 가장 먼저 그 부분부터 보완해야 한다. 여기에서 말하는 ‘사실’이란 합리적인 대상 독자라면 누구라도 진실로 받아들일 만한 모든 것을 가리키는 약칭이다. 여러분의 경험, 코드 예시, 테스트 결과, 그 외 신뢰할 수 있는 업계 지식 등을 포함한다.

이미 알고 있겠지만 기술 글의 독자는 신랄하고 회의적인 편이다. 독자가 여러분을 믿지 않으리라고 짐작했다면, 대체로 맞을 것이다. 개인적인 문제로 받아들일 필요는 없다. 그들은 아무도 믿지 않으니까. 하지만 사전에 이런 회의적인 태도를 염두에 두고 대비하면 좋다. 즉, “이건 사실이 아닙니다!”, “그게 사실이라는 근거가 뭐죠?”라는 대상 독자의 비난에 맞설 적정 수준의 다양한 사실을 글에 담아야 한다.