도큐먼팅
Posted 2006. 8. 29. 01:49아키텍처가 너무나 크고 힘든거 같다. 나에게는...
하지만 재미있다. 항상 나에게 도전을 준다. 아 도전...듣기만...
기업 아키텍처를 구축 하면서 가끔 document관련 책들을 읽는데 몇몇 문구가 눈에 확 보인다.
컨설팅은 눈높이다. 눈높이라는 말은 고객의 관점에서 보는 사람의 관점에서 문서가 적혀지고 설명되어야 한다는건데 규칙은 이러하다.
구구절절 옮은 이야기이고 컨설팅적인 기법이 아키텍처에도 그대로 쓰인다. 바바라민토 등
1. 읽는 사람의 관점에서 문서를 써야한다. -- 이게 컨설팅에서 한 30%먹는듯하다.
2. 불필요한 반복 줄이기... -- MECE
3. 모호성을 피하기 -- 당근빠따다. MECE
4. 표준 - 나는 이것에 원칙까지 첨부하고 싶다. 원칙없는 소프트웨어 아키텍처라니
5. 설계이유구성 - 이것도 당근이다. MECE에 해당하는 기법이다.
6. 문서를 최신으로 -.- : 젤 지키기 어렵지만 꼭 해야 하는거다.
7. 목적에 적합한 문서리뷰 - 이것도 당근빠따 어떤이는 이걸 소프트웨어 평가라고 하지만 다리잡고 말리고 싶다. 아키텍처 평가가 그리 쉬운게 아니기 때문에...
결국 쓰고나면 또 컨설팅인가... 에헤라디야...
아래글은 소프트웨어 아키텍처 인 프락티스와 소프트웨어 다큐먼팅 관련책에서 나온글들임
하지만 재미있다. 항상 나에게 도전을 준다. 아 도전...듣기만...
기업 아키텍처를 구축 하면서 가끔 document관련 책들을 읽는데 몇몇 문구가 눈에 확 보인다.
컨설팅은 눈높이다. 눈높이라는 말은 고객의 관점에서 보는 사람의 관점에서 문서가 적혀지고 설명되어야 한다는건데 규칙은 이러하다.
구구절절 옮은 이야기이고 컨설팅적인 기법이 아키텍처에도 그대로 쓰인다. 바바라민토 등
1. 읽는 사람의 관점에서 문서를 써야한다. -- 이게 컨설팅에서 한 30%먹는듯하다.
2. 불필요한 반복 줄이기... -- MECE
3. 모호성을 피하기 -- 당근빠따다. MECE
4. 표준 - 나는 이것에 원칙까지 첨부하고 싶다. 원칙없는 소프트웨어 아키텍처라니
5. 설계이유구성 - 이것도 당근이다. MECE에 해당하는 기법이다.
6. 문서를 최신으로 -.- : 젤 지키기 어렵지만 꼭 해야 하는거다.
7. 목적에 적합한 문서리뷰 - 이것도 당근빠따 어떤이는 이걸 소프트웨어 평가라고 하지만 다리잡고 말리고 싶다. 아키텍처 평가가 그리 쉬운게 아니기 때문에...
결국 쓰고나면 또 컨설팅인가... 에헤라디야...
아래글은 소프트웨어 아키텍처 인 프락티스와 소프트웨어 다큐먼팅 관련책에서 나온글들임
- Filed under : S/W Architecture
