Skip to content
This repository has been archived by the owner on Apr 6, 2024. It is now read-only.

Fix UserGuide.md as per PED suggestions #209

Merged
merged 5 commits into from
Nov 9, 2023

Conversation

limjunxian1
Copy link

Closes #163, closes #168, closes #192
This PR also:

  1. Updates ToC
  2. Summarises Visual Components Section (refer to below)

image

Copy link

codecov bot commented Nov 7, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (ada8718) 82.50% compared to head (4507143) 82.50%.
Report is 8 commits behind head on master.

❗ Current head 4507143 differs from pull request most recent head 255e904. Consider uploading reports for the commit 255e904 to get more accurate results

Additional details and impacted files
@@            Coverage Diff            @@
##             master     #209   +/-   ##
=========================================
  Coverage     82.50%   82.50%           
  Complexity      753      753           
=========================================
  Files            99       99           
  Lines          2327     2327           
  Branches        261      261           
=========================================
  Hits           1920     1920           
  Misses          339      339           
  Partials         68       68           
Files Coverage Δ
src/main/java/seedu/address/ui/PersonCard.java 88.88% <100.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copy link

@lordidiot lordidiot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks for working on making the topic headers consistent as well!
Have left a few comments with suggestions to consider before merging this.

@@ -54,16 +54,14 @@ Our guide uses **visual components** to highlight key information for your conve
<div>
<br>
<panel header=":fa-solid-book: **Command Parameter / Syntax Tables**" type="secondary" expanded no-close>
Large tables describing the **syntax or parameters** of **parameter-heavy commands**, or the **attributes of large models**, will be contained in a **collapsible grey panel** like this one with a **book icon** :fa-solid-book:.
This **collapsible grey panel** with the **book icon** contains large tables that describes the **syntax or parameters** of **parameter-heavy commands**, or the **attributes of large models** such as our [Person model](DeveloperGuide.md#model-component).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This **collapsible grey panel** with the **book icon** contains large tables that describes the **syntax or parameters** of **parameter-heavy commands**, or the **attributes of large models** such as our [Person model](DeveloperGuide.md#model-component).
This collapsible grey panel with the **book icon** contains large tables that describes the **syntax or parameters** of parameter-heavy commands, or the **attributes of large models** such as our [Person model](DeveloperGuide.md#model-component).

Would recommend unbolding these things so that the bolding for the other terms is more effective. Right now there is a feeling that everything is bolded.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agreed! fixed in 255e904

@@ -192,24 +191,24 @@ All planned enhancements will also be listed in the [Planned Enhancements / Know
* If you are using a PDF version of this document, be careful when copying and pasting commands that span multiple lines as space characters surrounding line-breaks may be omitted when copied over to the application.
</box>

## Manage Contacts
## Contact Management

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice


<box type="info" icon=":fa-solid-magnifying-glass:">

Below are some examples on how to use the command:

* `edit 1 tg/@johndoe e2/[email protected]`: Edits telegram to "@johndoe" and secondary email to "[email protected]" for contact at index 1 of your contact list.
* `edit 2 n/Betsy e/[email protected] a/Newgate Heavan p/98765411 t/bestfriend`: Edits name to "Besty", email to "[email protected]", address to "Newgate Heavan", phone to "98765411" and tag to "bestfriend" for contact at index 2 of your contact list.
* `edit 3 t/` Removes all existing tags for contact at index 3 of your contact list. <br> **Note: In this case, for the parameter `[t/TAG]`, you can only input once if you will like to remove all existing tags of your contact, e.g. `edit 3 t/ t/` will not work.**

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* `edit 3 t/` Removes all existing tags for contact at index 3 of your contact list. <br> **Note: In this case, for the parameter `[t/TAG]`, you can only input once if you will like to remove all existing tags of your contact, e.g. `edit 3 t/ t/` will not work.**
* `edit 3 t/` Removes all existing tags for contact at index 3 of your contact list. <br> **Note: In this case, for the `[t/TAG]` parameter, you can only input it once if you want to remove all existing tags from your contact, e.g. `edit 3 t/ t/` will not work.**

Consider rephrasing this like so.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this phrasing sounds better! fixed in 255e904

@limjunxian1 limjunxian1 merged commit a85b88a into AY2324S1-CS2103T-T13-2:master Nov 9, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
2 participants