Use case extensions did not clearly distinguish between "resumes at step x" and "use case ends"

[nus-se-script]

• Product version: 1.6
• Operating system: MacOS

Description

Some extensions say "resumes at step x" yet some say "use case ends" but what I observed is that they are mostly the same behavior in the app. This is very confusing and spread all over the Use Case section.

Steps to Reproduce

The appointment is already marked.

markappt 1 ic/S1234567A
markappt ic/S1234567A

Expected

The first one should be "use case ends" and the second one should be "resumes at step 1" and in the app there should be some difference.

Actual

They are exactly the same. An error message is displayed and my command is rejected.

Screenshots

---

_{[original: nus-cs2103-AY2425S2/pe-interim#2470] [original labels: severity.Low type.DocumentationBug]}

[awlarpi]

Team's Response

Thanks for the feedback. The distinction relates to user intent and expected next steps: "Resumes at step 1" is used when the user intended to perform an action but failed due to an error like incorrect command format or missing details (e.g., markappt ic/S1234567A). The system signals the error, expecting the user to correct it and retry the command. Conversely, "Use case ends" applies when the user's underlying goal is already met or the action is unnecessary (e.g., markappt 1 ic/S1234567A finding the appointment already marked). The system informs the user, concluding that specific attempt as there's nothing more to be done for it. In both situations, the command doesn't execute, the text box clears for correction or a new command, and a message is displayed – this behavior is expected. Nonetheless, we will still view it as a need for improvement for our Developer Guide to make it clearer during future iterations. We will put this under Severity.NotInScope.

Duplicate status (if any):

--