ORFA NOTES / 01
Notes
공식 사실과 공개 원문, 그리고 출처 중심의 정보 설계에 관한 기록입니다. 더 잘 보인다는 약속 대신 더 명확하게 읽히는 원문을 고민합니다.
링크가 있다고 근거가 되는 것은 아닙니다
공식 홈페이지 링크를 붙였다고, 소개 문장의 모든 내용이 확인되는 것은 아닙니다.
한 문장을 등록하기 전, 세 가지 확인
우리 서비스를 설명하는 첫 사실 하나.
A link is a starting point
A link to an official website does not support every claim about a project.
Before you publish one fact
Can a reader check your statement against the page you provide?
근거 링크와 사실 문장의 범위를 맞추는 방법
공식 페이지를 연결하는 일과 그 페이지가 문장을 뒷받침하는 일은 다릅니다. 링크는 확인을 시작할 위치를 알려줍니다. 문장에 담긴 대상과 조건까지 같아야 독자가 내용을 대조할 수 있습니다.
CSV 지원을 ‘모든 형식 지원’으로 넓히지 않기
가상의 ‘예시도구’를 통해 사실과 근거를 비교해봅니다. 이 글은 실제 고객 사례가 아닙니다.
공개 다운로드를 ‘아무 용도로 사용 가능’으로 바꾸지 않기
가상 데이터 프로젝트의 안내에 “월별 측정값을 CSV로 내려받을 수 있습니다”라고 적혀 있다고 가정해봅시다. 이것만으로 “누구나 모든 용도로 사용할 수 있습니다”라고 소개할 수는 없습니다. 다운로드 가능 여부와 이용 조건은 별도로 확인해야 합니다.
근거가 말하는 만큼만 씁니다
한 줄의 사실을 정리할 때, 마지막에 근거 주소를 붙이면 끝났다고 생각하기 쉽습니다. 하지만 공식 페이지가 있다는 것과 그 페이지가 문장 전체를 뒷받침한다는 것은 다릅니다.
신청을 받는다는 것과 참가가 확정된다는 것
가상 작성 예시입니다. 실제 행사·고객·발행 Source의 사례가 아닙니다.
코드를 공개했다는 것과 무엇이든 허용한다는 것
가상 작성 예시입니다. 실제 개발팀·저장소·발행 Source의 사례가 아닙니다.
오늘 발행했다고 오늘 기준일까요?
오늘 올린 글이라도, 그 안의 사실은 작년 기준일 수 있습니다.
Published today. True as of when?
A post published today can describe last year’s facts.
기능이 바뀌면 소개 문장도 다시 확인하세요
제품은 바뀌었는데 소개 문장은 그대로인가요?
A date is context, not proof
“As of today” is useful context. It is not evidence by itself.
발행일은 확인일이 아니다
지난주에는 한 문장이 설명하는 기능과 범위를 좁혔습니다. 이번에는 그 문장이 언제 기준으로 성립하는지 살펴봅니다.
플랜 조건이 있는 기능 한 줄
플랜 이름 옆에, 언제 기준인지도 남겨보세요.
데이터의 세 가지 날짜
오늘 소개한 데이터가 오늘의 데이터는 아닙니다.
등록한 정보와 검증된 정보는 다릅니다
공식 URL을 입력하고 설명을 붙이면, 그 정보는 공개된 출처가 됩니다. 하지만 등록 버튼을 눌렀다는 이유만으로 내용이 독립적으로 검증되는 것은 아닙니다. ORFA를 설명할 때 가장 먼저 분리해야 할 두 가지입니다.
ORFA가 자기 설명을 Source로 남겼을 때
ORFA 운영자가 직접 등록한 Source 사례입니다. 외부 고객의 참여나 독립 검증 사례가 아닙니다.
기능과 적용 조건을 함께 남기는 법
다음은 작성 방법을 설명하는 가상 예시입니다. 실제 업체·사용자·발행 Source의 사례가 아닙니다.
데이터가 있다는 사실보다, 무엇을 담고 있는지가 먼저입니다
“누구나 활용할 수 있는 다양한 데이터를 공개합니다.”
“어떤 파일이든” 대신, 지원하는 파일을 적어보세요
“어떤 파일이든 바로 정리해줍니다.”
등록 버튼을 누르기 전: 공식 사실 한 줄의 범위를 정하는 방법
서비스를 소개하는 문장은 쉽게 길어집니다. 기능을 빠짐없이 알리고 싶고, 우리가 만든 차이도 설명하고 싶기 때문입니다. 하지만 누군가 다시 확인할 수 있는 공개 원문을 만들 때는 정보의 양보다 문장의 범위가 먼저입니다.
When a fact needs a boundary
A useful product fact also says where it stops.
One fact, a clear scope
What is one fact someone should know about your project?
ORFA에 무엇을 등록하면 될까요?
ORFA에 무엇을 등록하면 될까요? 길게 홍보하기보다 확인할 수 있는 사실 하나부터 시작해보세요.
우리 서비스를 한 가지 사실로 설명한다면?
우리 서비스를 처음 보는 사람에게, 딱 한 가지 사실만 전한다면 무엇일까요?
회사 소개는 있는데, 왜 ‘공식 사실 하나’의 주소는 없을까?
출시일, 지원 언어, 무료 플랜, 제공 지역처럼 확인 가능한 공식 사실 하나에 고유한 공개 URL이 필요한 이유를 설명합니다.
한 문장을 짧게 쓰는 것과, 출처로 설계하는 것은 다릅니다
공식 정보 하나를 다시 확인할 수 있는 주소. ORFA가 Source를 설계할 때 먼저 보는 기준입니다.
제품 기능 한 가지를 공식 사실로 쓰는 방법
실제 업체 사례가 아닌 가상 예시로, 제품 기능의 범위와 근거를 명확하게 쓰는 방법을 설명합니다.
연구·데이터 자원의 공개 범위를 쓰는 방법
실제 프로젝트 사례가 아닌 가상 예시로, 라이선스와 공개 범위를 추정 없이 쓰는 방법을 설명합니다.