UG has conflicting usage instructions for the `shelf` command between the `help` command section and the actual `shelf` section.

[RyanLing169]

Here is the help portion of the UG

which tells users to use the shelf function as shown:

However, the shelf section instructs to use the command as shown:

which contradicts the earlier instructions, In that an additional "/" character is required between the shelf command and the "genre" keyword

[nus-se-script]

[IMPORTANT!: Please do not edit or reply to this comment using the GitHub UI. You can respond to it using CATcher during the next phase of the PE]

Team's Response

Similar issue to issue #28

The 'Original' Bug

[The team marked this bug as a duplicate of the following bug]

The help function provides wrong information on how to use the shelf command.

Here is the output of the help function:

zooming in on the shelf function,

However, when using this format, users are greeted with this error:

which is the only time this format is shown, with an extra "/" between the shelf and "genre" keywords

---

_{[original: nus-cs2113-AY2425S2/pe-interim#42] [original labels: type.FunctionalityBug severity.Medium]}

Their Response to the 'Original' Bug

[This is the team's response to the above 'original' bug]

Thank you for highlighting this issue. After consideration, we will accept this bug as the help output currently shows shelf GENRE / SHELF_NUMBER, which is misleading. The actual accepted format is shelf / GENRE / INDEX, as enforced by the program output error message. We acknowledge that this inconsistency can lead to confusion when referencing the help command, even though the correct format is documented in the User Guide. We’ll look into improving this in future versions.

We’re accepting this as a documentation bug with severity.Low, as the discrepancy does not prevent usage but can cause minor inconvenience.

Items for the Tester to Verify

❓ Issue duplicate status

Team chose to mark this issue as a duplicate of another issue (as explained in the Team's response above)

• I disagree

Reason for disagreement: [replace this with your explanation]

---

❓ Issue type

Team chose [type.FunctionalityBug]
Originally [type.DocumentationBug]

• I disagree

Reason for disagreement: [replace this with your explanation]

---

❓ Issue severity

Team chose [severity.Low]
Originally [severity.Medium]

• I disagree

Reason for disagreement: From user's perspective, the issue in the help function would cause inconvenince as the reliance on the help function to use commands would be higher than the UG itself.

---