숫자보다 정의를 먼저 쓴다

이 글은 숫자를 쓰기 전에 정의를 먼저 정하는 원칙을 설명한다. 국제표준을 읽을 때도 같은 원칙을 쓴다. 표준 문서의 필드 이름을 외우기 전에, 무엇을 한 건으로 볼지 정해야 한다.

숫자는 글을 그럴듯하게 보이게 만든다. 그러나 출처와 단위가 없는 숫자는 판단 근거가 아니다. “개선”, “고도화”, “인사이트” 같은 말도 마찬가지다. 측정 단위가 없으면 읽는 사람마다 다른 대상을 떠올린다.

먼저 정할 것

숫자가 아직 없어도 정할 수 있는 것이 있다. 이 네 가지가 정리되면, 나중에 숫자가 붙어도 해석이 흔들릴 가능성이 줄어든다.

표준 글에 적용하는 방식

OneRoster와 xAPI를 설명할 때도 먼저 단위를 정한다. OneRoster 글에서는 “누가 어느 반에 속하는가”가 단위다. xAPI 글에서는 “누가 무엇을 어떤 대상에 했는가”가 단위다.

단위가 정해지기 전에는 숫자를 붙이지 않는다. “연동률이 높다”거나 “학습 효과가 개선됐다”는 말도 쓰지 않는다. 그 숫자가 어떤 단위를 세는지 아직 설명하지 않았기 때문이다.

이 사이트에서의 규칙

이 사이트에서는 증명되지 않은 성과 수치를 꾸미지 않는다. 공개할 결과물이 있으면 Projects에 둔다. 아직 숫자가 없으면 수치를 만들지 않고, 정의와 범위를 먼저 남긴다.

국제표준의 전체 구조는 국제표준은 시스템 사이의 계약이다에 둔다. 명단 데이터는 OneRoster는 누가 그 반인지를 넘긴다에서 다룬다. 학습 기록은 학습 기록은 한 줄이 한 건이다에서 다룬다.