공식 문서와 live API response가 다를 때 어느 쪽을 먼저 보여줘야 할까요?

official docs와 live API response가 충돌할 때 source note의 lead source를 고르는 질문.

공식 문서와 live API response가 다를 때 문서에서는 어느 쪽을 먼저 보여줘야 할지 고민됩니다. 공식 문서는 intended contract이고, live response는 오늘 실제 디버깅에 더 가깝습니다. 저는 둘을 합치지 말고 documented rule, observed behavior, checked date, scope를 나눠 적는 편이 안전하다고 봅니다. 그래도 첫 줄은 어느 쪽이 더 낫다고 보시나요?