Week 2 [Mon, Aug 19th] - Project

iP:

  1. Learn about the project
  2. Set up prerequisites
  3. Set up the project in your computer
  4. Add Increments while committing frequently: Level-0, Level-1, Level-2, Level-3, Level-4, A-TextUiTesting, Level-5, Level-6, A-Enums Fri, Aug 23rd 1600

iP

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, although it is fine to stay ahead of the schedule a bit (but no more than a week ahead).
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 be done in each week. Clumping all the iP work into a short burst of work will not earn you 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:

As per the above, you have until the next weekly briefing (i.e., Friday 1600) to finish this week's iP tasks, but if you fail to do so, we won't penalize you if you can catch up within one more week after that deadline.

1 Learn about the project

  • Read the following two sections, if you haven't done so already:

Admin iP - Overview


Admin iP - Grading


2 Set up prerequisites

  • Ensure you have followed the Preparation sections of the following course tools:

Admin Programming Language


3 Set up the project in your computer

Read through this week's topics before starting the project.
If you encounter technical problems while doing the iP, follow the guidelines given below:

Admin Appendix D: Getting Help


  1. Fork https://github.com/nus-cs2103-AY2425S1/ip, while noting the points below:
    Keep the fork name as ip 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 course.
    Untick the [ ] Copy the master branch only option so that you get a copy of the full repo.
  2. Enable the issue tracker of your fork (Go to Settings of your fork, scroll to the Features section, and tick the Issues 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 URL https://github.com/{your_user_name}/ip/issues
    e.g., https://github.com/johnDoe/ip/issues
  3. Clone the fork onto your computer.
  4. Set up the project in your IDE as explained in the README file, if you plan to use an IDE for the project.

4 Add Increments while committing frequently: Level-0, Level-1, Level-2, Level-3, Level-4, A-TextUiTesting, Level-5, Level-6, A-Enums Fri, Aug 23rd 1600

Implement the given below in the given order.

Keep in mind ...
  • 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 that completed the increment with the exact increment ID e.g., Level-2, A-TextUiTesting
      Git tags are not the same as Git commit messages.
      %%{init: { 'theme': 'default', 'gitGraph': {'mainBranchName': 'master'}} }%% gitGraph commit id: "..." commit id: "Rename main class" commit id: "Add greeting" tag: "Level-0" commit id: "Add support for echo" commit id: "Fix bug in echo" tag: "Level-1" commit id: "Add support for list" commit id: "Add support for bye"
    • git push the code to your fork
      Git 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 visiting https://github.com/YOUR_USER_NAME/REPO_NAME/tags e.g., https://github.com/se-edu/addressbook-level3/tags
      If you encounter issues connecting Sourcetree with your GitHub account, refer to this Sourcetree Tutorial.
  • The relevant textbook topics are:

  • Remember to take note of our plagiarism policies, if you haven't done so already:

iP feels like 'same same' ...?

As you do the iP, if you feel like you are not learning enough new stuff as you've done similar work before (at least on the Java/OOP side), there is an alternative approach you can take to the iP. See the panel below if you are interested.

Duke Level-0: Rename, Greet, Exit

Duke Level-1: Echo

Duke Level-2: Add, List

Duke Level-3: Mark as Done

Duke Level-4: ToDo, Event, Deadline

Duke A-TextUiTesting: Automated Text UI Testing

Duke Level-5: Handle Errors

Duke Level-6: Delete

Duke A-Enums: Use Enums if-applicable

FAQ about iP increments

FAQ How are the iP git tags used in grading?


FAQ What if I discovered a bug after I finished an increment?


FAQ I did multiple increments in the same commit. How to fix?


FAQ The requirements of an increment scheduled for this week is already satisfied by the work I did in an earlier week. What now?


FAQ My iP increments are not detected by the dashboard because I forgot to push my tags earlier. What now?


FAQ Oh no! I made a mistake in my tag/branch name.