iP:
A-Assertions
, A-CodeQuality
, A-Streams
A-CI
tP:
.jar
file is smaller than 5MB, most likely JavaFX libraries are not inside it.A-FullCommitMessage
.A-Assertions
, A-CodeQuality
, A-Streams
branch-Level-8
etc.), but do not merge any.master
branch). Be careful not to create a PR to the upstream repo. If you did create such a PR by mistake, no worries, just close it yourself.Create merge commit
option when merging.master
branch of your local repo to fall behind that of your fork (). Therefore, you need to sync the local master
with the remote master
branch. One way to do that is to switch to the local master
branch and then pull the updated master
branch from your fork e.g.,$ git checkout master
$ git pull origin master
master
. To rectify, merge the master
branch to each of them. Resolve merge conflicts, if any.A-CI
B-DoWithinPeriodTasks
or C-Sort
or D-Places
BCD-Extension
to the corresponding commit.BCD-Extension
.Discuss with your team members to ensure that each member picks a different extension.
You may want to pick an extension that is potentially relevant to your tP so that the code can be reused in the tP later, if possible.
You can do this step as if the tP is a greenfield project (i.e., as if there is no AB3), to get the full experience of this activity. Some of the user stories you come up with may already be implemented in AB3, but that can be sorted out later.
Follow the steps in the recipe mentioned above to arrive at user stories for the product, with your team members. If you don't follow the recipe mentioned above, you could end up with a different set of user stories than otherwise.
User stories for what version? At this stage, collect user stories to cover at least the final version you hope to deliver at the end of the semester. It is OK to go even beyond that (reason: we are simulating a project that will continue even after the semester is over).
Do not omit user stories already covered by the features in AB3 i.e., the user story should be recorded even if AB3 already caters for it.
How many user stories? Aim to collect more user stories than you can deliver in the project. Aim to create at least 30 user stories. Include all 'obvious' ones you can think of but also look for 'non obvious' ones that you think are likely to be missed by other competing products.
User stories of what size? Normally, it is fine to use epic-level user stories in the early stages of a project but given this is a small project, you may want to eventually break them down to smaller user stories (i.e., small enough for one person to implement in 1-2 days). Some examples (from the iP product domain):
What format?: You may use a sentence format or a table format but do maintain the prescribed three-part structure of a user story. In particular, try to include the benefit part in most user stories as that will come in handy when prioritizing user stories later.
Submission (to be checked by the tutor later):
If you choose to use the GitHub issue tracker to manage user stories, you need to set up your team's GitHub organization, team repo, and its issue tracker first. Instructions for doing those steps are in the panel below.
Intuitively, you might think the right thing to do is to decide what features will be in v1.4 and then plan the intermediate versions based on that. But that's not what we are going to do.
Why? Given the difficulty of reliably estimating the effort each feature will need, any such long-range plan is likely to be inaccurate.
Instead, what we will do is to assume the current iteration is the last iteration, plan that iteration to deliver the product (based on available time), and try to follow that plan as best as we can. After the iteration is over, we plan the next iteration as if it's the last iteration. But that time, you can factor in the experience from the previous iteration to do a better job of planning.
How is that better?
The goal of this activity is to come up with the smallest possible product that is still usable so that it can be implemented as v1.2, to be delivered at the end of the first project iteration i.e., NOT what you can or want to do in v1.2, but what you must do in v1.2. We try to make it small because you will have only two weeks to implement v1.2 and coding as a team is a lot harder than writing code alone.
Why v1.2 and not v1.1? v1.1 is a mere documentation update only. v1.2 will be the first version that contains functionality changes.
Do not discuss features, UI, command format, or implementation details yet. That would be like putting the cart before the horse. At this stage we are simply trying to choose which user needs to fulfill first.
Suggested workflow:
FAQs
Q: What if the chosen user stories for v1.2 is not enough to do a meaningful work division among team members?
A: In that case, at a later stage, you can add more user stories until there is enough for a meaningful work distribution. But at this point focus on selecting the smallest sub-set of must_have user stories only.
Q: Should we start implementing v1.2 now?
A: Not at all. That is scheduled several weeks later. For now, just figure out the minimal feature set required for the product. We'll let you know when it is time to start working on v1.2.
Q: Should we omit user stories that are already supported by AB3?
A: No, you should still include them. Reason: The existing implementation might still require some work before it fits your product.
Q: All the user stories we selected for v1.2 are already supported by AB3. What now?
A: That's fine. It means you can get to v1.2 with very little effort, which is a good thing. Once you've finished v1.2, if there is time left, you can add more things to it (e.g., v1.2.1 etc.) at that time.