using "diff old new" is preferred
[tridge/comp8440.git] / assessment.php
1 <?php
2 include "8440head.php";
3 ?>
4
5
6
7 <center>
8 <h1>
9 <font color="#931515" size="+3">COMP8440: Assessment</font>
10 </h1>
11 </center>
12
13
14 Course assessment will be divided into 3 parts
15
16 <ul>
17 <li>Short presentation - 15%</li>
18 <li>Project work - 45%</li>
19 <li>Project study - 40%</li>
20 </ul>
21
22 <p>Students will have an opportunity to discuss the assessment options
23 during the information evening.
24
25
26 <h1>Short presentation</h1>
27
28 On Saturday the 23rd of April each student will make a short
29 presentation on their chosen FOSS project. That presentation should
30 provide basic information on the project and its structure, and
31 present the work that you have done during the lab times over the
32 previous week. 
33
34 <p>While this presentation is part of your assessment, it is also a
35 chance for you to get feedback that you can use to help produce good
36 reports for the remaining two main parts of the assessment.
37
38 <p>To assist with your presentation you may choose either to have a
39 set of LibreOffice slides, or a set of web pages.
40
41 <h1>Project work</h1>
42
43 <p><b>Due Monday the 23rd of May</b></p>
44
45 The project work part of your assessment comes from you working on a
46 FOSS project of your choice. There are no strict rules on what form
47 that work should take, but you should try to choose something that
48 demonstrates your ability to work with the project, and demonstrates
49 your understanding of the principles of FOSS collaboration.<p>
50
51 Assessment for this portion of the course will be based on a report
52 that you write that describes your involvement with the project. The
53 report should describe all of your interactions with the project. To
54 assist you in writing that report, make sure that you keep copies of
55 all email exchanges with the project, plus logs of any IRC
56 interactions and copies of relevant web pages (for example bug
57 submissions). <p>
58
59 The FOSS project you choose for this part of your assessment does not
60 have to be the same project that you chose during the intensive part
61 of the course (the one you used for your Saturday short
62 presentation). It is suggested, however, that if you decide to use a
63 different project that you discuss your choice with one of the course
64 coordinators (Andrew or Bob).<p>
65
66 It is important that the work you do for this part of your assessment
67 is not done in isolation from the other contributors to your chosen
68 FOSS project. You should not work alone on a patch or other
69 contribution and then submit it to the project at the last
70 minute. Instead, you should discuss your contribution as soon as
71 possible, and actively participate in a cycle of review and
72 improvement, with the aim of producing a useful contribution to the
73 project.<p>
74
75 It is also not a requirement that the project accept your contribution
76 to get a good mark for this part of your assessment. With the short
77 time available for this course, it is expected that many students will
78 be not have an accepted submission by the time the project work report
79 is due. What you should aim to demonstrate in your report is that you
80 are following the established practices for your chosen project, and
81 that you have been working towards a useful contribution.<p>
82
83 You also do not need to restrict yourself to a single contribution to
84 the project. For example, you may wish to make contributions to
85 several different areas of the project. Contributions to the
86 documentation, web pages, test suites and bug handling can be just as
87 important as contributions to the projects source code.<p>
88
89
90 <h1>Project Study</h1>
91
92 <p><b>Due Monday the 23rd of May</b></p>
93
94 The project study is a moderately detailed study of your chosen FOSS
95 project. The study should cover all of the aspects of FOSS development
96 covered in the course that are relevant to the project of your
97 choice. In the study you should seek to demonstrate your understanding
98 of the COMP8440 lecture material.<p>
99
100 The subject of your project study does not need to be the same FOSS
101 project as the one you used for the project work portion of your
102 assessment. For example, if you think that the project you have been
103 working with will not easily allow you to demonstrate your knowledge
104 of the course material, then you may wish to choose a different
105 project. You may also include information about more than one project
106 if that helps, perhaps by comparing and contrasting aspects of two
107 projects.<p>
108
109 As a rough guide, the report is expected to be about 10 to 15 pages
110 long.<p>
111
112 The study should cover at least:<p>
113 <ul>
114 <li>The history of the project</li>
115 <li>The project governance structure</li>
116 <li>The projects source code management practices</li>
117 <li>Statistics on project contributors</li>
118 <li>Information on who uses the project</li>
119 <li>Information on any interactions or relationships with other projects</li>
120 <li>Legal and licensing information</li>
121 <li>The motivations behind the project</li>
122 <li>How releases are managed</li>
123 <li>How bug tracking is handled</li>
124 </ul>
125
126 If possible you should try to document the discussions and background
127 that led to the choices the project made. <p>
128
129 You should try where possible to research the answers through publicly
130 available materials. If you can't find the answers that way, then you
131 can contact project members, but you should make it clear that you are
132 working on a university project. Including a link to the <a
133 href="http://cs.anu.edu.au/students/comp8440/">COMP8440 web site</a>
134 in your first contact with a project member is a good way to do this.
135
136 <h1>Submission</h1>
137
138 Please submit your assignments by the due date
139 to <a href="mailto:comp8440@cs.anu.edu.au">comp8440@cs.anu.edu.au</a><p>
140
141 Please send your assignments either as a PDF or as LibreOffice
142 documents.
143
144 <h1>Plagiarism</h1>
145
146 Plagiarism is taken very seriously in this course, and in the FOSS
147 community in general. If you use someone elses work in making your
148 assignment, then you must cite that work, giving credit where credit
149 is due. If you don't then you may receive zero for the whole
150 assignment. Please cite carefully! If in doubt, ask Bob or Andrew for
151 assistance.
152
153 <h1>Assessment FAQ</h1>
154
155 A number of students have asked me some questions later about the assessment.
156 In case anyone else has similar questions, here are the answers in FAQ format.
157
158 <p>Q: Are two separate reports required for the assessment?
159
160 <p>A: Yes, one report is the project study, and the other report is on your
161 project work
162
163
164 <p>Q: What is the difference between the two reports?
165
166 <p>A: The 'project study' report is a study of a particular FOSS project
167 from the point of view of the material we covered during the lectures.
168 This study is not about what you have contributed to the project, it
169 is about the project itself, and should cover things like the history
170 of the project, the culture of the project, how the project interacts
171 with other projects, the legal and licensing framework for the project,
172 how the project is funded, how decisions are made, how the project is
173 governed, what motivates the developers working on the project etc. You
174 should try to use the report to demonstrate your understanding of the
175 lecture material.
176
177 <p>The other report, called the "project work" report, is about what you
178 yourself have contributed to the project. It should document all of
179 your interactions with your chosen project, and should aim to demonstrate
180 that you understand how to effectively communicate and contribute to a
181 FOSS project.
182
183
184 <p>Q: Can the two reports be on different FOSS projects?
185
186 <p>A: Yes, that is entirely up to you
187
188
189 <p>Q: Can the 'project study' report be on something other than a specific
190 project, but instead be on a topic that is important for the FOSS
191 world?
192
193 <p>A: Yes, but please contact Bob or myself for approval of a project study
194 that is not on a specific FOSS project.
195
196 <p>Q: I submitted a bug report for my project, and now the bug has
197 been fixed.  Should I include that in my project work report?
198
199 <p>A: yes! The process demonstrates that you are working well with the
200 development community for your project. You should include your patch
201 submission, any discussion of the patch and the result of the
202 submission in your report.
203
204 <p><div align="center">
205   <?php
206     print " Last modified: ";
207     $last_modified = getlastmod();
208     print(date("j/m/Y, H:i", $last_modified));
209   ?>
210 </div><p>
211
212 <?php
213 include "8440tail.php";
214 ?>
215
216
217