- Learn about the project
- Set up prerequisites
- Set up the project in your computer
- Add Increments while committing frequently:
Level-1
,Level-2
,Level-3
,Level-4
,A-TextUiTesting
,Level-5
,Level-6
,A-Enums
Thu, Aug 18th 2359
The iP (and the tP) undergoes changes after each semester. As such, teething issues are a possibility. If you encounter any problem while doing the iP/tP, please post in the forum so that we can take necessary actions.
We discourage you from doing project tasks allocated to future weeks. Reasons: In order to help you gain (and also to better simulate real projects), we want the project work to be and span a longer period, rather than to be done as a short burst.
Reminder: as per iP grading criteria, some increments need to to be done in each week for you to get full marks.
Please follow instructions carefully. Any deviations can cause our grading scripts to miss your work (and result in you not getting credit for the work).
Deadline:
Note the typical deadline weekly project tasks:
But as there are no tutorials this week, you have until the next lecture to finish this week's iP tasks.
1 Learn about the project
- Read the following two sections, if you haven't done so already:
2 Set up prerequisites
- Ensure you have followed the Preparation sections of the following module tools:
3 Set up the project in your computer
- Read through this week's topics before starting the project.
- Fork https://github.com/nus-cs2103-AY2223S1/ip.
Please keep the fork name asip
or else our grading scripts will not be able to detect it. You can change the fork name to something else after the semester (and the grading) is over e.g., after receiving your grade for the module. - Enable the issue tracker of your fork (Go to
Settings
of your fork, scroll to theFeatures
section, and tick theIssues
checkbox). Reason: at times we post feedback on your issue tracker.If the issue tracker is enabled, you should be able to visit the following URLhttps://github.com/{your_user_name}/ip/issues
e.g.,https://github.com/johnDoe/ip/issues
- Clone the fork onto your computer.
- Set up the project in your IDE as explained in the README file.
If you encounter technical problems, follow the guidelines given below in seeking help:
4 Add Increments while committing frequently: Level-1
, Level-2
, Level-3
, Level-4
, A-TextUiTesting
, Level-5
, Level-6
, A-Enums
Thu, Aug 18th 2359
- Implement the following in the given order.
- From this point onward, commit code at important points. Minimally, commit after completing each increment.
Remember not to commit.class
files and any other file that should not be revision controlled.
- From this point onward, after completing each increment,
git tag
the commit with the exact increment ID e.g.,Level-2
,A-TextUiTesting
Git tags are not the same as Git commit messages.git push
the code to your forkGit doesn't push tags unless you specifically ask it to. After pushing a tag to your fork, you should be able to see that tag by visitinghttps://github.com/YOUR_USER_NAME/REPO_NAME/tags
e.g., https://github.com/se-edu/addressbook-level3/tagsIf you encounter issues connecting Sourcetree with your GitHub account, refer to these Sourcetree Tips.
FAQ about iP increments
- Q. How are the iP git tags used in grading?
A. A git tag is a self-declaration that you think you are done with the iP increment. We take your word for it. We don't check the code to see if you have actually done the said increment. Therefore, it is just a mechanism for you to self-declare progress and for us to monitor those progress declarations. - Q. What if I discovered a bug after I finished an increment?
A. Go ahead and fix it in a subsequent commit. There is no need to update the previous commit or move the corresponding tag to the new commit. As we do not test your code at every tag, earlier bugs will not affect your grade as long as they are fixed later. Similarly, feel free to improve the code of previous increments later. - Q. I did multiple increments in the same commit. How to fix?
A. You can add the corresponding tags to the same commit.
Optionally, if you haven't pushed the commit to the fork yet, you can try to figure out how to split that commit into multiple commits. - Q. The requirements of an increment scheduled for this week is already satisfied by the work I did in an earlier week. What now?
A. You can add the corresponding tag to the earlier commit (or the latest commit -- it doesn't matter) and push the tag. - Q. My iP increments are not detected by the dashboard because I forgot to push my tags earlier. What now?
A. Not to worry. Just push the tags now. They will be detected by the dashboard at the next update. There is no penalty if mistakes are detected and fixed soon after. - Q. Oh no! I made a mistake in my tag/branch name.
A. It's OK; correct it now.