- Fix PE-D bugs
- Submit final deliverables Tue, Nov 12th 14:00
- Submit the demo video
- Prepare for the practical exam
- Attend the practical exam during the lecture on Fri, Nov 15th
- [if needed] Attend the backup practical exam Sun, Nov 17th 1400-1600
1 Fix PE-D bugs
- Triage bugs you received in the PE-D, by following the procedure given below:
- Do your own testing. Don't rely on PE-D alone to find bugs. The panel below contains guidelines your peers will use when determining bugs in the final product -- knowing them might be useful in preventing such bugs in your product in the first place.
- Fix bugs that you deem as important enough to be fixed in v2.1. Also keep in mind that bug fixing can cause regressions which you'll have to catch and fix.
2 Submit final deliverables Tue, Nov 12th 14:00
- Deadline for all v2.1 submissions is Tue, Nov 12th 14:00:00 unless stated otherwise. Note that 14:00:01 is considered late, as per the Canvas deadline mechanism.
- Penalty for late submission (per file):
-1 mark for missing the deadline (up to 2 hour of delay).
-2 for an extended delay (up to 24 hours late).
Penalty for delays beyond 24 hours is determined on a case by case basis.- Even a one-second delay is considered late, irrespective of the reason.
- For submissions done via Canvas, the submission time is the timestamp shown by Canvas.
- When determining the late submission penalty, we take the latest submission even if the same exact file was submitted earlier. Do not submit the same file multiple times if you want to avoid unnecessary late submission penalties.
- The whole team is penalized for problems in team submissions e.g., a -1 penalty for a team submission will be a -1 penalty for each team member.
Only the respective student is penalized for problems in individual submissions.
- Submit via the Canvas assignment we have set up. CS2113T students: documents should be submitted to both courses. It's not enough to submit to CS2101 side only.
- Follow submission instructions closely. Any non-compliance will be penalized. e.g. wrong file name/format.
Canvas might automatically add a file name suffix (e.g.,*-1.pdf,*-2.pdf, ...) if you upload a file multiple times. You can safely ignore that suffix. - Do not update the code during the 14 days after the deadline. Get our permission first if you need to update the code in the repo during that code-freeze period.
- You can update issues/milestones/PRs even during the code-freeze period.
- [CS2113T only] You can update the source code of the docs (but not functional/test code) if your CS2101 submission deadline is later than our submission deadline. However, a code-freeze period of 1-2 days is still recommended, so that there is a clear gap between the tP submission and subsequent docs updates.
On a related note, there is no need to additional stylistic 'beautifications' to the docs before submitting to CS2101 side. The two teaching teams have agreed that there will be no extra credit for such additional beautifications. - You can update the code during the code-freeze period if the change is related to a late submission approved by us.
- You can continue to evolve your repo after the code-freeze period.
Submissions:
Don't take PDF conversion lightly: To convert the UG/DG/PPP into PDF format, go to the generated page in your project's github.io site and use this technique to save as a pdf file. Using other techniques or not following the settings suggested in the given technique can result in issues such as missing background colors, poor quality resolution, unnecessarily large files (the last two can be considered as bugs).
The PDF versions of the UG/DG/PPP should be usable by the target readers, even if not as neat/optimized as the Web versions. For example, margins and page breaks need not be optimized, but they should not hinder the reader either. Assume some will occasionally choose the PDF version over the Web version e.g, for printing, offline viewing, annotating etc.
PE uses the PDF versions of UG/DG, not the Web version! Any problems in those PDF files (e.g., broken links, messed up formatting) can be reported as bugs.
Ensure hyperlinks in the pdf files work. Broken/non-working hyperlinks in the PDF files will be considered as bugs. Again, use the conversion technique given above to ensure links in the PDF files work.
PDF files should,
- be paginated at a reasonable page size (e.g., A4). Reason: single-page PDF files don't work well in some PDF viewers, and not suitable for printing either.
- allow copying text so that readers can copy text from them (e.g., copy an example command from the UG).
Try the PDF conversion early. If you do it at the last minute, you may not have time to fix any problems in the generated PDF files (such problems are more common than you think).
Side benefits for early submissions: Given that using buffers to reduce the risk of deadline overruns is a learning outcome of this course, we strongly encourage setting an internal submission deadline a few hours earlier than the actual deadline. As an incentive, we plan to perform some checks on early submissions and inform you if we found issues with your submission (e.g., incorrect file name/format), thus giving you a chance to fix them before the deadline and avoid a penalty for it.
You may use automated tools to improve documentation: e.g., tools such as Grammarly may be used to improve the writing quality and find grammar errors.
The icon indicates team submissions. Only one person need to submit on behalf of the team but we recommend that others help verify the submission is in order.
We will not entertain requests to limit late penalties of team submissions to one person even if the delay was one person's fault. That is, the responsibility (and the penalty) for team submissions are to be shared by the whole team rather than burden one person with it.
- Product:
- Do a release on GitHub, tagged appropriately e.g.,
v2.1orv2.1b. - Upload the jar file to Canvas.
File name:[team ID][ProductName].jare.g. [CS2113-T09-2][ContactsPlus].jar
Recommended to avoid spaces and special characters in the product name as it can cause problems when running the JAR file using the command line.
This name requirement is for the JAR file you upload to Canvas only. You may name the JAR file you upload to GitHub in any reasonable way.
- Do a release on GitHub, tagged appropriately e.g.,
- Source Code: Push the code to GitHub and tag with the version number.
Reminder: double-check to ensure the code attributed to you by RepoSense is correct.
- User Guide:
- Convert to pdf and upload to Canvas.
- File name:
[TEAM_ID][ProductName]UG.pdfe.g.[CS2113-T09-2][ContactsPlus]UG.pdf
- Developer Guide:
- submission is similar to the UG
- File name:
[TEAM_ID][ProductName]DG.pdfe.g. [CS2113-T09-2][ContactsPlus]DG.pdf
- Project Portfolio Page (PPP):
- HTML version: make available on
github.io - PDF file: submission is similar to the UG
File name:[TEAM_ID][Your full Name as Given in Canvas]PPP.pdfe.g.[CS2113-T09-2][Leow Wai Kit, John]PPP.pdf
Use-in place of/if your name has it e.g.,Ravi s/o Veegan→Ravi s-o Veegan(reason: Windows does not allow/in file names)
- HTML version: make available on
- Product Website: Update website (home page,
AboutUs.mdetc.) on GitHub. Ensure the website is auto-published.
3 Submit the demo video
4 Prepare for the practical exam
- After reading the above 2, we strongly recommend you read ahead the info given in the item 6 below as well, to know in advance what will happen during the PE itself.
5 Attend the practical exam during the lecture on Fri, Nov 15th
- Ensure you read the instructions on PE Preparation (given in item 5 above)
- Attend the practical test, to be done during the lecture.
6 [if needed] Attend the backup practical exam Sun, Nov 17th 1400-1600
- In the very unlikely event that the PE had to be cancelled due to technical issues, attend the backup PE on this day.
- Note: This is not an alternative option for students who could not attend the PE, as all students need to do the PE at the same time.