-
Notifications
You must be signed in to change notification settings - Fork 4
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
UG and DG Enhancements and Fix Find Command #132
Conversation
docs/DeveloperGuide.md
Outdated
|
||
Team size: 4 | ||
|
||
4. The current implementation of the find command allows users to search for contacts based on their names, tags, or company names. However, it does not support searching by address, email, or phone number. We acknowledge that the ability to search by these fields can significantly enhance user experience by providing more flexibility and efficiency in locating contact information. The initial decision to exclude address, email, and phone number from the search criteria was based on a focus on the most commonly used identifiers for quick search and to maintain simplicity in the search interface. We also considered the privacy implications and the less frequent necessity of searching by personal information such as phone numbers or addresses. However, in order to enhance the utility of our contact management system, we are planning to introduce expanded search capabilities. This will include the ability to search for contacts by their phone numbers, email addresses, and physical addresses. This enhancement aims to provide a comprehensive search functionality that meets the needs of all users, making the tool more versatile and efficient for locating specific entries. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it would be better if you follow the format given in Week 12 Project section (the bold text at the start)
+ "Parameters: n/KEYWORD [MORE_KEYWORDS]... t/KEYWORD [MORE_KEYWORDS]... c/KEYWORD [MORE_KEYWORDS]...\n" | ||
+ "Example: " + COMMAND_WORD + " n/alice t/friends c/Meat \n" | ||
+ "Note: Multiple keywords (name, tag or company) are treated with a logical AND."; | ||
+ "Parameters: [n/NAME_KEYWORDS] [t/TAG_KEYWORDS] [c/COMPANY_KEYWORDS]\n" | ||
+ "Each field is optional, " | ||
+ "but at least one must be provided. All Keywords are combined using logical AND (&&).\n" | ||
+ "Example: " + COMMAND_WORD + " n/alice t/friends c/Meat - " | ||
+ "Finds all persons named 'alice' AND tagged as 'friends' AND who's company name is " | ||
+ "associated with 'Meat'.\n"; | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hmm not sure if this violate feature freeze?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I believe this is just an update to documentation - no change made to the actual command
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@@ -583,3 +583,6 @@ to view their newly added order. We plan to show a preview of the order added. F | |||
3. **Raise error when an outdated order date is added:** The current date validation does not check if the | |||
order date is outdated when `addorder` command is called. We plan to raise an error when an outdated order date | |||
is added. For example: `Order date cannot be in the past`. | |||
|
|||
4. **Improve Search Functionality**: The current implementation of the find command allows users to search for contacts based on their names, tags, or company names. However, it does not support searching by address, email, or phone number. We acknowledge that the ability to search by these fields can significantly enhance user experience by providing more flexibility and efficiency in locating contact information. The initial decision to exclude address, email, and phone number from the search criteria was based on a focus on the most commonly used identifiers for quick search and to maintain simplicity in the search interface. We also considered the privacy implications and the less frequent necessity of searching by personal information such as phone numbers or addresses. However, in order to enhance the utility of our contact management system, we are planning to introduce expanded search capabilities. This will include the ability to search for contacts by their phone numbers, email addresses, and physical addresses. This enhancement aims to provide a comprehensive search functionality that meets the needs of all users, making the tool more versatile and efficient for locating specific entries. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should bold the :
as well 😆
@@ -235,46 +235,50 @@ Examples: | |||
- Search feature supports substring search by name and/or tags and/or company **ONLY**. | |||
- Finds all contacts whose names, tags or company matches the substring keyword provided. | |||
|
|||
|
|||
General Format: `find FIELD/ KEYWORD FIELD/ KEYWORD ...` | |||
General Format: `find [FIELD/KEYWORD] [FIELD/KEYWORD] ...` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should the first [FIELD/KEYWORD]
be compulsory?
find
#96find
by email #91