Report - Marking Scheme The report is marked out of 50 (19 individual + 31 group marks) by the supervisor from the School and the unit coordinator. Suggested break down: 1. Context out of 12 (7 individual and 5 group) 2. System design out of 12 (group) 3. Evaluation out of 12 (group) 4. Project management - out of 12 (individual) 5. Conclusions out of 2 (group) 6. Presentation of the report penalty for inappropriate presentation will apply INFO3600 Major Software Development Project, s2 2007 1 Project Distribution in Electronic Version In addition to the hard copy of the report you need to submit a CD to your supervisors and unit coordinator. It must contain the following: 1. The report in e-version (format: word, pdf or ps) 2. Complete source code (your code should be fully documented) 3. readme file containing instructions on how to compile, install and run your program 4. The URL for the demo version of your system (if applicable) This requirement is omitted for students working with industry who have signed a non-disclosure agreement. INFO3600 Major Software Development Project, s2 2007 2 INFO3600 Major Development Project, s2 2007 1
Submission of the report and the CD Submit a hard copy of the report and the accompanying CD: to your supervisors (from industry and University) to the unit coordinator - in the INFO3600 box Do not forget to attach a signed cover sheet (Academic Honesty). It is available from the course web page. Deadline: Week 13 (Friday, 5pm) Late submissions: a penalty of 1 mark per each day after the deadline will apply, and after 7 days the report will not be accepted INFO3600 Major Software Development Project, s2 2007 3 Presentation of the Report Language is appropriate for the audience (an IT professional who is not an expert in large scale software development) 12pt font Good use of tables and diagrams Grammatical sentences, clear and concise Good layout Note on the page guidelines The indicated page numbers are just rough guidelines and they will vary depending on the nature of the project and number of students in the group. Keep the report clear and concise, the emphasize should be on high quality rather than quantity. INFO3600 Major Software Development Project, s2 2007 4 INFO3600 Major Development Project, s2 2007 2
Appendices References Main chapters Table of contents Abstract page Cover page INFO3600 Major Software Development Project, s2 2007 5 Cover page TITLE Group name Group members with SIDs INFO3600 Major Software Development Project Semester 2, 2007 Supervisors Submission date INFO3600 Major Software Development Project, s2 2007 6 INFO3600 Major Development Project, s2 2007 3
Abstract page Title Authors Abstract Easy-to-read description of what your product does Not for a computer scientist, oriented toward a high-school student or a newspaper reader About 100 words Acknowledgements Company Supervisor Anyone else helpful INFO3600 Major Software Development Project, s2 2007 7 Table of contents Chapter 1 Page # Section 1.1 Section 1.2... Etc Chapter 2 Chapter 3... Etc References Appendix 1 Appendix 2... Etc. INFO3600 Major Software Development Project, s2 2007 8 INFO3600 Major Development Project, s2 2007 4
Main chapters INFO3600 Major Software Development Project, s2 2007 9 Chapter 1. Context [~3-4 pages, marked out of 12: 7 individual and 5 group] 1.1 Introduction (group writes this together) What is the problem that your group s work addresses? What are your main goals? 1.2 Overview of the company and significance of the group s work (each student writes this individually, ~1 page each) What are the main interests and activities of the company? How does the department you were assigned to fit in the company s structure? How will your group s work be used by the company? How does it relate to existing systems and processes? How does it aid innovation? Why is your group s work significant in the overall work of the company? 1.3 Related work - summary of exploration of comparable systems (group writes this together) What products are competing with yours? What general methods are used to make this kind of product? What are the limitations of previous work or competing products? INFO3600 Major Software Development Project, s2 2007 10 INFO3600 Major Development Project, s2 2007 5
Chapter 2. System Design (group writes this together) [marked out of 12, group mark] 2.1 Background Tools and Concepts (~2 pages) What tools (compilers, libraries, existing code and hardware) and resources did you use and why? What coding and design methods methods did you use and why? What algorithms did you use and why? 2.2 System architecture (~6 pages) Overview Diagram showing the relationships between the main modules Modules and their interfaces Short description of each of the main modules, their interfaces and how they fit into the system as a whole; show also the author(s) of each module 2.3 User operations (~6 pages; many pictures and few words) How do the users interact with the system? What operations do they perform? Walk through user scenarios, show screenshots if appropriate INFO3600 Major Software Development Project, s2 2007 11 Chapter 3: Evaluation (group writes this together) [marked out of 12, group mark] 3.1 Testing procedures, tools and results (~4 pages) How did you test your work? Briefly describe the procedures followed and tools used. What are the results of your tests? Performance, correctness, usability testing You may need charts and graphs 3.2 Interpretation of these results (~1-2 pages) Give some honest conclusions about the quality of your work Does the product serve the basic goals for the user community as set originally in the requirements document? The original requirement and planning report should be included in the Appendix so that the marker can refer to it Does the outcome provide significant use to the client community beyond what was originally planned? Is your work of good quality (this would be reflected in features such as easy to use, robustness, extensibility)? What are the strengths and weaknesses of your work? Suggest further extensions and improvements INFO3600 Major Software Development Project, s2 2007 12 INFO3600 Major Development Project, s2 2007 6
Chapter 4. Project management (each student writes their own part) [marked out of 12, individual mark], ~2 pages each Project plan and execution What was the initial plan and what actually happened (week by week) When did the milestones occur? Scope and schedule Did you have the right scope for the given time? Did you have a feasible schedule? Tools and skills Did you choose the right tools? Did you have the right skills coming into the project? Difficulties What were the difficulties in your part of the project? How were these difficulties overcome? Group management (e.g. project integration and communication management) What was the best thing of your group management? What were the areas for improvement? Lessons learned What were the most valuable things you have learned from this project? INFO3600 Major Software Development Project, s2 2007 13 Chapter 5. Conclusion (group writes this together) [marked out of 2, group mark] Concluding remarks Summary of the strengths and weaknesses of the product you produced and the process you followed What you would have done differently if you could do it again Future work: enhancements and improvements to the product, better ways to organize future projects ~1/2 page INFO3600 Major Software Development Project, s2 2007 14 INFO3600 Major Development Project, s2 2007 7
References It is recommended that you use a bibliographic management software such as Endnote for organising your references Endnote is available to all students from the library s web site and the library also runs tutorials http://www.library.usyd.edu.au/databases/endnote/endnote.html There are different formats for entering and citing references. Choose one of them and be consistent. Here is one possibility [adapted from Annals of Software Engineering, Springer]: - References 1. 1. Sommerville, I. (1992), Software Engineering, Fourth Edition, Addison Wesley, Reading, MA. [books] 2. 2. Parnas, D.L., J. van Schouwen and P.K. Shu (1990), "Evaluation of Safety Critical Software," Communications of the ACM 33, 6, 636 65. [journals] 3. Quirk, W.J., Ed. (1985), Verification and Validation of Real Time Software, Springer Verlag, Berlin, Germany. [edited books] 4. Teitelman, W. and L. Masinter (1981), "The Interlisp Programming Environment," In Tutorial: Software Development Environments, A.I. Wassernan, Ed., IEEE Computer Society Press, Los Alamitos, CA, pp. 73 81. [in a book] 5. Franke, D.W. and M.K. Purvis (1991), "Hardware/Software Codesign: A Perspective, "In Proceedings of the 13th International Conference on Software Engineering, IEEE Computer Society Press, Los Alamitos, CA, pp. 344 352. [in conference proceedings] 6. Arthur, J.D., R.E. Nance and O. Balci (1992), "Establishing Software Development Process Control: Technical Objectives, Operational Requirements, and the Foundation Framework," Technical Report TR 92 40, Department of Computer Science, Virginia Tech, Blacksburg, VA Technical Report. [technical report] 7. Perl Style Guide, http://www.perl.org/press/style-guide.html [on-line reference] - Citing references from text by their number, e.g. [1], [1,3,7], etc. INFO3600 Major Software Development Project, s2 2007 15 Etc Feedback from users/client community Readme file Some source code Photos of usage Appendices -Include the original Requirements and Planning report INFO3600 Major Software Development Project, s2 2007 16 INFO3600 Major Development Project, s2 2007 8