데이터 링크는 같은 페이지에 문서가 포함된 주소에 게시된 데이터세트이므로 누군가가 열의 의미를 묻지 않고도 사용할 수 있습니다.
파일은 쉬운 부분입니다. 문서는 데이터를 사용 가능하게 만드는 것입니다.
이 가이드에서는 형식, 문서에서 답변해야 하는 5가지 사항, 버전 관리 및 라이선스를 다룹니다.
CSV(이유가 없는 한)
표 형식 데이터의 경우 CSV가 올바른 기본값입니다.
모든 도구에서 읽을 수 있으며 버전 호환성 문제가 없으며 정확한 데이터만 포함하고 있습니다. 이와 대조적으로 통합 문서에는 숨겨진 시트, 수식, 필터링된 행 및 작성자 메타데이터가 포함되어 있어 보내려는 것보다 더 많고 사용자가 작업하기가 더 어렵습니다.
청중의 의미 있는 부분이 코드 작성이라면 JSON을 함께 제공하세요. 테이블 형식이 아닌 계층적 형식의 경우 JSON이 기본 형식이어야 합니다.
지원 이메일을 차단하는 몇 가지 CSV 세부정보입니다.
- UTF-8, 인코딩이 명시되어 있습니다. 그렇지 않으면 이름과 장소 이름이 깨집니다.
- ISO 날짜, 2026-09-18. 모호한 형식은 표시되지 않는 오류를 발생시킵니다.
- 짧고 컴퓨터 친화적인 열 이름이 포함된 헤더 행입니다.
- 병합된 셀 없음, 빈 행 없음, 합계 행 없음. 합계는 데이터가 아닌 페이지에 속합니다.
- 파일당 하나의 테이블. 하나의 CSV에 있는 두 개의 테이블은 CSV가 아닙니다.
문서가 대답해야 할 5가지 사항
사용자가 이메일로 보내는 모든 질문은 다음 중 하나입니다.
| 질문 | 무엇을 진술할 것인가 |
|---|---|
| 이 칼럼은 무엇을 의미하나요? | 열당 문장, 일반 단어 |
| 어떤 단위 | 열당. 통화 및 어떤 통화 |
| 빈 셀은 무엇을 의미합니까? | 공백, 0, 해당 없음은 다릅니다. |
| 어느 기간에 해당되나요? | 시작과 끝, 중요한 경우 시간대는 무엇입니까? |
| 그것은 어디서 왔는가? | 소스 및 처리 방법 |
세 번째는 가장 자주 놓치고 가장 큰 피해를 주는 것입니다. 결측값을 0으로 처리하는 사용자는 자신 있게 잘못된 답을 내놓을 것입니다.
<table class="cols">
<tr><th>Column</th><th>Meaning</th><th>Units</th></tr>
<tr><td>gauge_id</td><td>Station identifier, stable across years</td><td>-</td></tr>
<tr><td>load_mean</td><td>Monthly mean sediment load</td><td>mg/L</td></tr>
<tr><td>records</td><td>Readings the mean is calculated from</td><td>count</td></tr>
</table>
해당 예의 마지막 열은 보기보다 더 중요합니다. 4번의 판독값으로 계산된 평균은 400번의 평균값과 동일한 주장이 아니며, 수치를 게시하면 사용자가 판단할 수 있습니다.
네가 거기에 무슨 짓을 했는지 말해봐
원시 데이터는 드뭅니다. 게시된 거의 모든 내용이 정리, 집계 또는 수정되었습니다.
뭐라고 말해보세요. 제외된 행과 이유, 간격을 채운 방법, 이상값 제거 여부, 반올림된 항목. 3일보다 짧은 간격을 보간했음을 아는 사용자는 그것이 자신의 목적에 적합한지 결정할 수 있습니다.
이것은 또한 누군가가 당신의 인물을 재현할 수 있게 하는 것이기도 합니다. 보고서의 숫자가 데이터에서 얻은 숫자와 일치하지 않는 경우 처리 메모에 차이가 표시됩니다.
버전 관리
주소가 무엇을 의미하는지 결정하고 그렇게 말하십시오.
항상 현재 추출을 보유하는 "최신" 주소는 자동화된 모든 작업에 유용합니다. 움직이는 표적을 가리키는 인용은 인용이 아니기 때문에 보고서의 데이터를 인용하는 사람에게는 날짜가 있는 주소가 필요합니다.
둘 다 수행하십시오. 절대 변경되지 않는 오래된 파일과 리디렉션되는 최신 링크. 누구도 추측할 수 없도록 페이지에 규칙을 명시하세요.
이전 버전을 유지하세요. 누군가는 지난 분기의 수치가 왜 다른지 알아내야 할 것이며, 그 수치의 출처를 삭제하면 불가능합니다.
라이선스
누구든지 사용할 수 있다는 대답이 있더라도 명확하게 설명하세요.
재배포 허용 여부를 알 수 없는 사용자는 귀하의 데이터를 회피하거나 사용하고 희망합니다. 데이터에 제3자의 내용이 포함되어 있는 경우, 귀하의 라이센스는 귀하가 소유하지 않은 자료에는 적용되지 않으므로 그것이 무엇인지, 어떤 조건에 따라 제공되는지 명시하십시오.
파일이 아닌 페이지에 속하는 것
데이터를 깨끗하게 유지하고 해석을 페이지에 넣으세요.
합계, 차트, 주목할 만한 결과 및 주의 사항은 모두 페이지 텍스트에 포함됩니다. CSV 내부의 합계 행은 이를 읽는 모든 도구를 깨뜨리고 통합 문서의 차트는 숫자를 분석하는 사람이 사용할 수 없습니다.
수치를 보여주고 제공하고 싶다면 링크할 대시보드에서 프레젠테이션 부분을 다룹니다.
주소에 넣어두세요
CSV를 게시하고, 모든 열을 해당 단위와 함께 문서화하고, 격차가 어떻게 표현되고 데이터에 무엇을 했는지 말하고, 버전 날짜를 지정하고, 라이선스를 명시하고, 공유 링크를 만듭니다.
그러면 아무도 열이 무엇을 의미하는지 묻는 이메일을 보낼 필요가 없습니다.