iP:
tP: v1.1
v1.1
) Thu, Mar 7th 23:59AboutUs
, README
v1.2
)If you wish to cite the iP in your resume, you can do more to make it look more impressive to a potential employer. These improvements are not considered for grading and can be done after the semester is over. Some ideas:
On a somewhat related note, you can also create similar product websites for your other projects (projects from other courses, pet projects).
v1.1
Start using Git via the CLI
If you have been using Sourcetree (or other GUI) for Git before, we strongly recommend that you move towards using the CLI to perform Git tasks in the second half of the semester. Doing so will strengthen your Git knowledge (because CLI takes you closer to what's actually happening, while GUIs might hide such details).
But you can continue to use your favorite Git GUI for a more 'visual' view of your repo, side-by-side with the CLI e.g., from Sourcetree, you can open a gitbash terminal, run the command in that terminal, and see the result in the GUI.
PR review comments matter! Remember to do proper PR reviews throughout the tP, at least for non-trivial changes, as the quality and quantity of PR review comments you have given to peers affect your tP marks (under the project management aspect).
v1.1
) Thu, Mar 7th 23:59A secondary purpose of this iteration v1.1
is to practice the required workflow while modifying some documentation files, before you start updating the code in the following iteration.
The panel below explains how to use GitHub to do a project iteration.
Strongly recommended to do this as a team activity (preferably F2F, or else connected via Zoom/MST), at least until everyone has merged a few PRs for this iteration. That will help you proceed faster (e.g., a PR can be reviewed immediately after it has been created) and will also make it easy for you to help each other w.r.t. to the workflow matters.
AboutUs
, README
Recommended procedure for updating docs:
Guidance on using documentation tools (e.g., How to preview changes locally before committing/pushing) can be found in the relevant section of the Developer Guide of your team project website that you set up earlier. Given below is a shortcut, for your convenience:
Lookout for these mistakes which were the most common in previous runs of the course:
master
branch) of your fork. This error means your PR will not be considered as following the forking workflow correctly.A: Update the following pages in your project repo:
/docs
folder) is used for course admin purposes. Please follow the format closely or else our scripts will not be able to give credit for your work.
docs/images/github_username_in_lower_case.png
JohnDoe123
-> docs/images/johndoe123.png
not docs/images/JohnDoe123.png
..png
anyway.README page: Update it to match your project.
Add a UI mockup of your intended final product.
Note that the image of the UI should be docs/images/Ui.png
so that it can be downloaded by our scripts. Limit the file to contain one screenshot/mockup only and ensure the new image is roughly the same height x width
proportions as the original one. Reason: when we compile these images from all teams into one page (example), yours should not look out of place.
The UI mock up can be a hand-drawn sketch or created using a tool such as PowerPoint, PlantUML, Figma, etc.
Can the AB3 screenshot used for this? Only in the unlikely case that your v1.2 UI looks exactly the same as AB3.
Update all contents to match your own project.
Update the link of the GitHub Actions build status badge () so that it reflects the build status of your team repo.
Acknowledge the original source of the code e.g.,
This project is based on the AddressBook-Level3 project created by the [SE-EDU initiative](https://se-education.org).
If you did the above updates correctly, your UI mock up and profile photos should appear in your project website and this Project List Page.
B: Also update site-wide settings, as necessary:
You need to update the AB-3
in the top navigation bar of your project website (it's in docs\_config.yml
and docs/_sass/minima/_base.scss
if using Jekyll; in docs\_markbind\layouts\default.md
if using MarkBind).
More info on updating site-wide settings such as the above:
Doing this task now means you'll have less to do later, but it is OK if you want to delay this until you have implemented the features.
Update the UG in your tP repo. While you can reuse some content from the feature specification that you did earlier, note that UG is intended for end users, and hence the format, level of details, pitching etc. need to match that audience. For example, the UG should not contain all the nitty-gritty details that is in the feature spec.
You can use the current AB3 UG for guidance on the format/flow/tone/level-of-details etc.
As mentioned before, while it is more convenient for one person to update the entire UG, we strongly recommend that each person updates their own part of the docs so that we can easily track the contribution of each member using RepoSense.
The scope of this update can be v1.2
i.e., only update features that you plan to have in that version.
Furthermore, as you haven't implemented v1.2
yet, this update will be somewhat speculative. The content may need to be tweaked later if the actual implementation of the feature deviated from the current plan.
Add the following to the DG, based on your project notes from the previous weeks. No need to update other sections, for now.
Some examples of these can be found in the AB3 Developer Guide.
The above DG sections should cover the full requirements of the product, some of which might not even get implemented by the end of this semester i.e., do not limit to just the requirements you intend to implement in the next iteration. Reason: All identified requirements need to be documented for future reference.
Furthermore, these sections will be graded at the final project evaluation, and any bugs in the content can cost you marks at that point. The panel below gives some relevant DG bug examples you can lookout for:
v1.2
)show a placeholder for photo, showing a generic default image
should be assigned to Jake and to milestone v1.2