아래 내용에서 '표준'의 출처는 'ISO/IEC 15910-2002'라고 합니다. 하지만 ISO 표준 문서에는 15910-2002라는 문서는 없습니다. 15910-1999가 마지막이고 그 이후에는 26512가 이를 대체합니다.
ISO/IEC 표준에 따르면 문서 한 페이지의 초안을 작성하는 데 1시간이 소요된다고 합니다.
ISO 표준에 따르면, 페이지당 내용 리뷰에는 30분, 단순 교정 작업에는 약 15분이 소요됩니다.
2023년 기준 26512:2018 문서가 최종이네요.
https://www.iso.org/standard/72088.html
ISO/IEC/IEEE 26512:2018
Systems and software engineering — Requirements for acquirers and suppliers of information for users
www.iso.org
해당 블로그 글에 표기된 출처를 보면 ISO 사이트 또는 문서를 바로 참조한 건 아니고 2013년 sigasi 웹사이트에 기고된 문서가 그 출처입니다. sigasi는 소프트웨어 설계를 지원하는 도구를 개발하는 회사입니다. documentation을 주제로 2012년 이후 14건의 글이 올라와 있습니다. 작성자는 Smrita인데 내부 직원은 아니고 외부 기술 블로거가 아닌가 싶습니다.
How much time is spent on writing documentation versus developing RTL code?
Design. Verify. Keep Moving.
insights.sigasi.com
문제는 이 문서가 Smrita라는 인물이 작성한 내용이 아니라는 겁니다. 본문 내 문장으로 검색해 보면 2개의 결과를 만날 수 있습니다. 하나는 위의 문서이고 하나는 philosoft 라는 곳의 문서입니다.
해당 문서를 보면 Mikhail Ostrogorskij라는 분이 작성했고 2008년에 작성한 글이네요.
http://philosoft-services.com/content/en/articles/metrix/metrix.html
http://philosoft-services.com/content/en/articles/metrix/metrix.html
Approach to Term Time Estimation in Technical Documentation Development Mikhail Ostrogorskij, 2008 Theses of Report at Documentation Today Conference, 2008. Why is It Important to Correctly Estimate Term Time One of the most painful questions that develope
philosoft-services.com
2013년보다 5년 전에 작성한 글이라는 거죠. 이 분이 러시아 개발자라고 생각하면 15910-2002라는 문서를 이해할 수 있습니다. 'ISO/IEC 15910-2019'를 러시아에서 번역해 표준으로 사용하는 것이 'GOST R ISO/IEC 15910:2002'입니다. Mikhail Ostrogorskij는 러시아 표준을 확인했을 것이고 러시아 기준으로 2002라고 표기한 것이죠.
자. 그렇게 2002라는 숫자가 어디서 나왔는지는 확인을 했습니다. 원문이 무단 복제되고 국내에서 이를 인용하면서 복제된 기사를 인용하다 보니 발생한 오해가 아닌가 싶네요.
그럼 원문은 정확한 내용일까요?
문서 작성 소요 시간이라는 표에서 ISO 표준과 함께 'READ ME 1ST'라는 문서가 언급되고 있습니다. 이 문서는 'Read Me First!: A Style Guide for the Computer Industry'라는 책입니다. Sun Technical publications에서 출판했고 1996년 초판이 나왔습니다. 2009년 3판을 마지막으로 더 이상 출판이 되지 않았습니다(2010년에 Sun을 오라클에서 인수하면서 중단된 것 같구요. 그렇지 않았더라면 계속 나올 수도 있었겠죠).
하여간 해당 도서 2판 기준으로 보면 아래와 같은 내용이 있습니다.
Mikhail Ostrogorskij가 작성한 내용과 비교해 보면 2가지 오류가 있습니다.
- (인용 오류) Reviewing이 아니라 Revising existing text(기존 문서 업데이트)에 대한 내용임
- (인용 오류) Indexing 작업은 5hours/page가 아니라 5pages per hour임. 0.2 hours/page가 적절
문서 작성 시간과 관련된 내용은 15910-1999 문서를 확인해봐야 하는데 이 문서를 찾지 못해서 ^^ 아마 폐기된 문서를 구입하기도 애매하고 해서... 혹 해당 문서가 있는 분께서 연락 주시면 좀 더 내용을 검토해 보도록 하겠습니다.
