MR-27 — API 사용 중단 공지의 버전별 문서·변경 기록 대조

조사·출처 확인: 2026-09-23 UTC. 범위는 미국 영어권 소규모 API 공급사가 엔드포인트 한 건의 사용 중단을 알릴 때 승인된 적용 버전·대체 경로·시점을 버전별 참조 문서, 공통 변경 기록, 선택적 구독 알림에 맞추는 일이다. 질문: 이 대조에 별도 구매 이유가 있는가? 원격 main 기준 94a9496826d0ea5b1cd06714ff4da45aef7ec8af. 고객 인터뷰·업무 관찰·유료 실험·외부 계정 실행은 각 0건이다. 공개 조사 준비 완료는 제품 출시 준비가 아니다. 기술 출시 추적은 #322다.

MR-08은 게임 패치·시즌 안내의 버전/지역/기간을 다뤘다. 이번 회차는 API의 작동 여부를 승인하는 엔지니어와 문서팀 사이의 버전별 참조 문서 대 공통 변경 기록으로 범위를 좁힌다. 직접 코딩 환경을 새 제품으로 제안하지 않는다.

고객·시장 근거

업무·구매자 가설: API 제품/엔지니어링 책임자가 사용 중단 범위·대체 호출·유효 시점을 승인하고, 문서 담당자가 버전별 참조·가이드와 공개 변경 기록을 고친다. 고객 커뮤니케이션 담당은 기존 구독 알림이 있다면 같은 메시지인지 확인한다. 구매자는 API 제품 책임자 또는 개발자 경험/문서 예산 책임자일 수 있다. 실제 담당·구매 권한·빈도·고객 불편·손실은 미확인이다.

반복 업무·현재 대안	공식 사실·공급자 설명 (2026-09-23 확인, 미국/영어 자료)	추론·판단 경계
사용 중단의 기술 근거	OpenAPI 3.1.1 규격은 operation의 deprecated: true를 정의한다. ReadMe API Reference는 OpenAPI 파일 업로드·Git 동기화·CLI 또는 수동 편집 경로를 제공한다.	deprecated 표시는 사용 중단 상태의 한 근거다. 특정 고객의 작동 버전·제거일·대체 경로가 맞는지는 API 소유자가 확인해야 한다. Wonffice가 실행 중 API와 스펙 일치를 보장한다고 주장하지 않는다.
버전별 문서 대 공통 변경 기록	ReadMe Versioning은 Guide/Reference를 버전별로 관리한다. Changelog는 버전 간 공유되며 버전별로 분기하지 않는다. 변경 기록 RSS도 제공한다.	추론: 공통 변경 기록에 한 버전의 종료일을 쓸 때 적용 버전을 명시하지 않으면 다른 버전 독자가 혼동할 수 있다. RSS를 구독해 알림을 만드는 경로는 있으나 이메일 실제 발송·수신을 보장하지 않는다.
기존 검토·자동화	ReadMe Reviews는 브랜치 변경의 diff·동료 승인을 지원한다. ReadMe CLI는 문서 lint, OpenAPI 검증, 참조 페이지 동기화를 설명한다. GitHub Releases는 릴리스 노트와 알림을 제공한다.	플랫폼 안의 검토·생성·알림 기능이 강한 대안이다. 기능이 있어도 특정 공지가 실제 API 버전·고객 알림과 일치했는지는 계정/산출물 실행 전 미검증이다.
공개 요금	ReadMe 미국 영어 가격은 Starter USD 0/월, Pro USD 250/월 상당·연 청구, Enterprise 별도 문의를 표시한다. 버전 문서는 Starter 1버전, Pro 이상 다중 버전을 안내한다. 가격 문서도 Pro 250/월을 적지만 청구 주기를 생략한다.	연 청구 조건은 상세 가격 페이지 기준으로 기록한다. 실제 지역·계약·세금·추가 연동비는 미확인이다. 공개 요금은 고객 지불 의사나 Wonffice 매출 증거가 아니다.

판단 — 추론: ReadMe의 OpenAPI 동기화·버전별 참조·리뷰·공통 변경 기록과 GitHub 릴리스/알림이 있으므로 범용 API 문서 게시·변경 기록 상품을 첫 alpha의 독립 우선순위로 추천하지 않는다. 남을 수 있는 좁은 업무는 승인된 적용 버전·대체 경로·시점이 각 버전의 참조 페이지와 공통 변경 기록에 같은 의미로 나타났는지 확인하는 것이다. 구독 이메일은 고객의 실제 발송 경로가 있을 때만 범위에 넣는다. 사용 중단 공지의 반복성과 추가 비용 승인 증거는 아직 없다.

도입 위험

현재 코드·공개 버전	재사용 가능 부분	추가 개발/연동·도입 장벽
main의 Note	사용 중단 안내나 검토 체크의 문장 초안. 호스트가 저장을 맡는 본문 편집 세션	스펙 권위·버전/엔드포인트 원장·승인 기록·검토 권한·ReadMe 게시·알림 발송은 확인된 기능이 아니다.
main의 Site	웹 초안·재사용 콘텐츠/내보내기 구성 요소	OpenAPI 참조 페이지, 다중 API 버전, 고객 구독 분류, 배포/접근 제어를 대체한다고 할 수 없다. 내보내기는 게시 URL이나 이메일 발송 증거가 아니다.
공개 배포·권리	npm @barocss/office-note·@barocss/office-site는 2026-09-23 조회한 버전 메타데이터상 각각 0.1.2다. MIT 라이선스는 상용 사용을 허용한다.	tarball 설치/실행 및 main과의 동일성 미검증. OpenAPI 검증·호스팅·권한/백업·게시 확인·고객 지원·연동 유지 비용이 별도다. #291 원본 추적과 #337 수동 인계는 계획/제안이다.

도입 경로 — 제안, 미실행: PM이 자료 사용을 허가한 API 공급사의 과거 사용 중단 공지 한 건을 확보한다. API 소유자가 승인한 버전·엔드포인트·대체 경로·시점과 실제 API/스펙의 관계를 먼저 확인한다. 버전별 참조 페이지, 공통 변경 기록, 구독 알림이 실제 존재했다면 그 발송/보존 증거를 사전에 정한 대상 목록으로 대조한다. 기존 ReadMe/GitHub+수동 체크표를 기준선으로 하고, Wonffice 초안·대조 흐름을 더했을 때 같은 종료 조건의 전체 시간·누락·지원비를 비교한다. 이메일 수신 증거가 없으면 전달 성공으로 세지 않는다. 고객 키·호출 로그·비공개 명세·수신자 개인정보는 공개 기록에 넣지 않는다.

출시 시점 요인: ReadMe의 버전/변경 기록/리뷰/요금, GitHub 릴리스 기능, OpenAPI 규격을 2026-09-23 위 URL에서 확인했다. ReadMe 문서는 최근 며칠 사이 갱신 표시가 있어 기능·요금제 경계가 바뀔 수 있다. PM/기술 담당은 고객 후보의 계정·요금제·버전/알림 설정을 비교 과제 직전 재확인한다. API 책임자는 해당 사용 중단 공지의 승인·게시 직전 실제 버전·대체 경로·날짜를 재확인한다. 특정 고객의 제거·릴리스·계약 갱신 일정은 미확인이다. 규격의 deprecated를 고객의 제거 일정으로 바꾸지 않는다.

미검증 가설·과금

• 사용 가치: API 문서팀은 같은 사용 중단 사실을 버전별 참조와 공통 변경 기록에 반복 반영하고, 적용 버전·날짜·대체 경로 오류를 뒤늦게 찾는다. 실제 발생·빈도·복구 비용·누가 수정 권한을 갖는지는 미확인이다. ReadMe 브랜치 리뷰·OpenAPI CI·수동 체크로 같은 정확도를 더 싸게 얻으면 기각한다.
• 구매 가치: API 제품/문서 예산 책임자가 버전 혼동·고객 문의를 줄이는 일에 별도 비용을 승인한다. 인터뷰·견적 반응·결제는 0건이다. ReadMe Pro 공개 가격은 이 가설의 증거가 아니다.
• 과금 후보: 실제 반복 과제와 비용 절감이 보이면 문서 검토 워크플로의 팀 단위 서비스 또는 제한된 이관·검수 지원을 #296에서 비교한다. 가격·계약·출시 약속은 정하지 않는다.
• 손익 민감도: 기존 총비용 = API 승인/스펙 검증 + 버전별 참조 수정 + 공통 변경 기록/선택 알림 작성·검수 + 기존 문서 플랫폼/CI/지원비; 후보 총비용 = 같은 API 승인/스펙 검증 + 자료 이관·권한/연동 + 같은 공개본·알림 검수 + 호스팅/백업·교육·지원 + 후보 요금; 순편익 = 기존 총비용 − 후보 총비용. 대상 버전 수, 사용 중단 공지 빈도, 수신 경로, 지원 문의와 리뷰 실패가 민감도다. 고객 입력값이 없어 손익분기점·시장 규모·매출은 계산하지 않는다.

반증/중단: 문서가 단일 버전이거나 사용 중단 공지가 드물거나, ReadMe/OpenAPI CI가 충분하거나, 실제 API와 승인 근거를 열람할 권한이 없거나, 새 이관·운영·지원비가 절감보다 크면 독립 상품 가설을 중단한다. 버전 원장·ReadMe/이메일 연동은 Product Master PM의 범위 변경 제안으로만 전달한다.

성과 측정 제안

Measurement-Contract, #289, #294, #297를 재사용한다. PM이 대상 집단·기간·합격선을 과제 전 고정한다. 분모 0은 0%가 아니라 미확인이다. 문서 초안 저장을 실제 API 동작이나 고객 알림의 대리 지표로 세지 않는다.

지표	대상·기간·분자/분모	자료 출처·담당 역할 제안
승인 사실 일치	허가된 과거 공지의 사전 지정한 적용 버전·대체 경로·시점 중 실제 스펙/버전별 참조·공통 변경 기록/존재한 알림에서 맞는 적격 항목 / 검증 가능한 채널·버전별 항목 전체. 미게시/증거 부재 별도 수	승인 기록·스펙/실제 동작 근거·게시 스냅샷·발송 기록. API 소유자·문서팀·QA·PMF. 현재 분모 0
독립 완료·총시간	같은 기간 승인→각 적격 문서 게시→존재한 알림 확인까지 도움 없이 끝낸 과제 / 시작한 적격 과제. 기존 ReadMe/CI+체크표와 같은 종료 조건의 총시간	허가된 작업·지원 기록. 문서팀·UX·QA·PMF. 현재 분모 0
사용·반복	합의 기간 실제 공지 대조를 끝낸 공급사 / 참여 동의한 적격 공급사. 다음 실제 사용 중단 공지가 생긴 활성 공급사 중 재사용 / 그 공지가 생긴 활성 공급사	승인된 작업·사용 기록. PM·PMF. 공지 미발생 집단 별도. 현재 분모 0
제안→유료·유지	동일 조건 제안 뒤 결제를 확인한 적격 예산 책임자 / 제안을 받은 적격 예산 책임자. 갱신 대상 유료 공급사 중 갱신 / 갱신 시점 도래 유료 공급사	제안·결제·환불·갱신 기록. Growth·PM·Operator. 현재 분모 0, 실제 배정 미확인
공지당 총비용	같은 공지의 승인·스펙 검증·문서/알림 검수·이관·지원·플랫폼/연동비를 기존 방식과 후보 방식에서 같은 기간 비교	시간·CI/지원 티켓·공급자 청구. Support·Operator·PMF. 현재 자료 없음

실제 사용·전환·유지 근거가 생기면 같은 버전·집단·기간의 가설과 결과를 비교해 유지·수정·보류 이유를 기록한다. 지금은 실적을 추정하지 않는다.

상태·PM 인계

상태	확인 결과·남은 위험	다음 담당 역할과 실제 배정
준비 완료	OpenAPI 표시, ReadMe의 버전별 참조·공통 변경 기록·RSS/리뷰/요금, main/npm 경계와 비용 변수의 공개 조사	Product Master PM이 실제 고객 접근 근거로 우선순위 검토. 연구 상태만 뜻함
미완료	과거 고객 공지에서 API 승인·버전별 게시·선택적 알림의 실제 일치와 기존 방식 총비용 비교	PM이 참여자·자료 권한 확정 뒤 API 소유자·문서팀·QA·UX·Support 역할 범위 확정
미확인	참여 공급사·승인/구매 권한·반복 손실·사용/지불 의사·고객 일정·증거 확보 담당과 실제 배정. 인터뷰·관찰·유료 실험·외부 계정 실행 각 0건	PM이 #289에서 참여자·증거 확보 담당과 실제 배정 근거를 확인. 조직 전체에 담당이 없다는 뜻은 아님
해당 없음	이번 조사에서 실제 고객 연락·API 변경·알림 발송·계약·가격·제품 전체 출시 판정	사업 판단 #296, 기술 출시 #322

새 이슈·출시 필수 조건은 추가하지 않는다. 다음 질문 후보: MR-28 — 독립 출판사의 개정판 도서 메타데이터가 ONIX 유통 피드·서점 상세·홍보 시트에 맞는지 대조하는 일에 별도 구매 이유가 있는가? MR-21 보드게임 규칙, MR-22 TRPG 개정본 전달과 중복 여부를 먼저 확인한다.

출처·제한: 외부 URL은 각 행에서 2026-09-23 확인했다. ReadMe 가격 문서는 Pro $250/월을 적지만 연 청구 여부를 표시하지 않는다. 상세 가격 페이지의 연 청구 조건을 적용했다. 공급자 기능은 특정 고객의 작업·구매 증거가 아니다. npm은 버전 메타데이터만 조회했고 tarball 설치/실행은 하지 않았다. 고객 API 키·계약·비공개 스펙·수신자 자료는 확보·공개하지 않았다.

게시 인계: 시장 연구 #326 댓글, 고객군 Discussion #287 댓글. 두 게시의 작성 계정 easylogic을 확인했다. 회차 문서·인계 확인: 2026-09-23T05:36:54Z. 최종 Wiki commit·완료 UTC는 로컬 운영 상태에 기록한다.