1. WARNING These slides are not optimized for printing or exam preparation. These are for lecture delivery only. These slides are made for PowerPoint 2010. They may not show up well on other PowerPoint versions. You can download PowerPoint 2010 viewer from here.here These slides contain a lot of animations. For optimal results, watch in slideshow mode.

2. RULES!!!

9. How is the takeover going?

12. The M in RTFM : When Code is not Enough CS2103/T, Lecture 7, Part 2, [Mar 6, 2015]

13. Developer-to-developer docs The M in RTFM : When Code is not Enough

14. Developer-to-developer docs

16. for developer as user for developer as maintainer

18. Developer-to-developer docs for developer as user for developer as maintainer

19. Developer-to-developer docs for developer as user for developer as maintainer

20. Do Don’t Do Don’t Do Don’t Do Don’t

22. Just enough docs As much docs as possible

23. Top-down Bottom up

30. 300,000+ LoC (Lines of Code) 700+ source files 1 week to start coding

31. Docs from code White elephants

32. Docs from code White elephants

33. Comprehensible Comprehensive Use cases Class diagrams Sequence diagrams

34. Use cases Class diagrams Sequence diagrams

35. Remember the purpose

36. So, how many class diagrams to include?

37. Comprehensible Comprehensive Docs from code White elephants Top-down Bottom up Just enough docs As much docs as possible Remember the purpose

38. What does STFW (a cousin of RTFM) stands for? stands {answer} e.g. stands see the fine wife stands {answer} e.g. stands see the fine wife 77577 OR tinyurl.com/answerpost GIYF LMGTFY