[실용주의 프로그래머] 결국은 모두 글쓰기 [실용주의 프로그래머] 결국은 모두 글쓰기 -아무리 흐린 먹물이라도 가장 훌륭한 기억력보다 낫다 - 중국 속담 -프로젝트에서 생산되는 문서에는 기본적으로 내부, 외부의 두 종류가 있다.내부 문서에는 소스코드, 주석, 설계와 테스트 문서 등이 포함된다.누구를 독자로 생각하는지, 또는 작가의 역할(개발자 혹은 테크니컬 라이터)이 무엇인지 불문하고, 모든 문서는 코드의 거울이다.불일치가 있다면 중요한 것은 코드다. 좋건 나쁘건. -문서가 애초부터 전체의 일부가 되게 하고, 나중에 집어넣으려고 하지 말라. -코드에는 주석이 있어야 하지만, 너무 많은 것은 너무 적은 것만큼이나 좋지 않다. -일반적으로 주석은 왜 이렇게 되어 있는지, 그 목적을 논해야 한다. 코드가 이미 어떻게 되어 있는지 보여 주기 때문에 이에.. 2018. 11. 16. [실용주의 프로그래머] 요구사항의 구렁텅이 [실용주의 프로그래머] 요구사항의 구렁텅이 -완성이라는 것은 더 이상 더할 것이 없을 때가 아니라, 더 이상 빼낼 것이 없을 때 얻게 되는 것이다. - 생택쥐페리 -요구사항이 지면에 놓여져 있는 경우는 퍽 드물다. 보통은 가정과 오해, 정치의 지층들 속 깊이 묻혀져 있다. -요구사항을 수집하지 말고 채굴하라. -어느 것이 진정한 요구사항인지 어떻게 분간할 수 있을까?요구사항이란, 어떤 것이 성취되어야 한다는 진술이다. ex) 직원 기록은 지명된 사람들만 볼 수 있다. 해당 직원의 관리자와 인사부에서만 그의 기록을 열람할 수 있다. -> 비지니스 정책이 내포된 진술로 수시로 바뀔 수 있다. 요구사항에 이를 고정하는 건 그리 좋은 생각이 아니다.실린더헤드 온도는 임계값을 넘으면 안 되며, 이는 엔진마다 다르.. 2018. 11. 8. 반응형 이전 1 다음
