Public Logs
Log는 정리된 work record입니다. Private operational detail이 아니라 무엇을 배웠는지를 남겨야 합니다.
Public log는 post보다 짧고, project보다 artifact 중심이 약하며, infra runbook보다 사건/결정의 맥락이 강합니다.
용도
- 공개 가능한 debugging writeup.
- 결과 공유가 안전해진 뒤의 reproducible experiment summary.
- project milestone과 design decision.
- 나중에 Posts로 확장될 수 있는 짧은 note.
어디에 둘까
| 중심 | 둘 곳 |
|---|---|
| 짧은 공개 작업 기록, 사건, 결정 | Public Logs |
| 실제 구현물, pipeline, tool, release | Projects |
| 일반화된 서버/HPC 운영 지식 | Infra |
| 독자를 위한 완성된 설명 글 | Posts |
| 논문 하나의 claim과 evidence | Papers |
| 재사용 가능한 정의, 수식, protocol | Concepts |
형식
- Public log taxonomy
- Public log format
- Log promotion rule
- Public incident note
- Sanitization checklist
공개 로그 체크
| Check | Why |
|---|---|
| What happened? | event를 일반화된 형태로 남깁니다 |
| What evidence is safe? | raw internal log 대신 error class와 public-safe signal만 씁니다 |
| What decision changed? | 다음에 같은 상황에서 판단 기준이 됩니다 |
| What should be omitted? | private path, host, account, collaborator, unpublished metric을 제거합니다 |
| Where should it promote? | Project, Infra, Post, Paper, Concept 중 다음 위치를 정합니다 |
포함하지 말 것
- server IP, port, username, private path, credential, node name.
- internal project name, collaborator detail, private dataset.
- unpublished experiment result 또는 thesis-sensitive claim.