Skip to content

Commit

Permalink
Merge pull request nus-cs2103-AY1819S2#86 from kthSim/docs
Browse files Browse the repository at this point in the history
UserGuide updates
  • Loading branch information
kthSim authored Mar 25, 2019
2 parents 7e7b256 + 5898e4f commit fa16043
Show file tree
Hide file tree
Showing 7 changed files with 62 additions and 26 deletions.
4 changes: 2 additions & 2 deletions README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
= OurTeeth (Morphed from Address Book Level 4)
= TeethHub (Morphed from Address Book Level 4)
ifdef::env-github,env-browser[:relfileprefix: docs/]

https://travis-ci.org/CS2103-AY1819S2-W17-2/main[image:https://travis-ci.org/CS2103-AY1819S2-W17-2/main.svg?branch=master["Build Status", link="https://travis-ci.org/CS2103-AY1819S2-W17-2/main"]]
Expand All @@ -12,7 +12,7 @@ ifndef::env-github[]
image::images/Ui.png[width="600"]
endif::[]

* This is a desktop OurTeeth application. It has a GUI but most of the user interactions happen using a CLI (Command
* This is a desktop TeethHub application. It has a GUI but most of the user interactions happen using a CLI (Command
Line Interface).
* Targeted towards Dentists who prefer to type.
* It is developed in Java through the efforts of a five man team from NUS
Expand Down
2 changes: 1 addition & 1 deletion docs/AboutUs.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
:imagesDir: images
:stylesDir: stylesheets

OurTeeth was developed by the W17-02 Team
TeethHub was developed by the W17-02 Team

The basis of our product, AddressBook - Level 4, was developed by the https://se-edu.github.io/docs/Team.html[se-edu]
team. +
Expand Down
2 changes: 1 addition & 1 deletion docs/DeveloperGuide.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
= OurTeeth - Developer Guide
= TeethHub - Developer Guide
:site-section: DeveloperGuide
:toc:
:toc-title:
Expand Down
68 changes: 52 additions & 16 deletions docs/UserGuide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,34 @@ It should start in a few seconds and begin the initialization set-up.
If you need the full list of available commands and their associated details, please proceed to <<quick-start-guide>>!

== Commands and Features
*Command Format*

* Words in `UPPER_CASE` are the parameters to be supplied by the user e.g. in add n/NAME, NAME is
a parameter which can be used as add n/John Doe.

* Items in square brackets are optional.

* Parameters can be in any order e.g. if the command specifies `n/NAME ic/NRIC dob/DATE_OF_BIRTH`,
`dob/DATE_OF_BIRTH n/NAME ic/NRIC ` is also acceptable.

=== Breakdown of attributes used within TeethHub
[cols=",,,", options="header",]
|===
4+^|List of valid prefixes

4+^|Unique Prefixes
2+| *Patient* 2+| *Record*
|Prefix | Attribute | Prefix | Attribute
|a/ | Address 2.7+|
|dob/ | Date of Birth
|e/ | Email
|ic/ | Nric
|n/ | Name
|p/ | Phone
|sex/ | Sex
4+^|Common Prefixes

|===

=== Help

Expand All @@ -78,7 +106,7 @@ You can use *Import* to add select patients from another patient list to your cu
+
You can use *Export* to save select patients to a .json or .pdf file.

==== Open
==== open
Opens the file in the specified file path and overwrites the current patients list.
** Note that 'open' always searches inside the data folder.
** You can only open .json files.
Expand All @@ -94,7 +122,7 @@ Replaces the current patients list with the patients list in "patients1.json".
Replaces the current patients list with the patients list in "patients2.json" found in the "february" folder.


==== Save
==== save
Saves the current patients list to the specified filepath.
** Note that 'save' always saves inside the data folder. If no such filepath exists,
it will be created. Otherwise, it will overwrite the existing file.
Expand All @@ -113,7 +141,7 @@ Saves the current patients list to "patients1.json".
Saves the current patients list to "patients2.json" found in the "february" folder.


==== Import
==== import
Opens the file in the specified file path and adds the specified patients to the patients list.
** Note that 'import' always searches inside the data folder.
** You can only import .json files.
Expand All @@ -138,7 +166,7 @@ Adds patient 1 to patient 4 from "patients1.json" to the current patients list.
Adds patient 1 and patient 3 to patient 5 from "patients1.json" to the current patients list.


==== Export
==== export
Saves the specified patients in the current patients list to the specified filepath.
** Note that 'export' always saves inside the data folder. If no such filepath exists,
it will be created. Otherwise, it will overwrite the existing file.
Expand Down Expand Up @@ -431,13 +459,17 @@ newly created teeth layout.
write a note describing more detail on the patient’s teeth
health.

=== List
=== Viewing and Locating Information
The commands listed below deal with displaying and finding data for you to view.
They do not deal with the adding or modification of any information currently already
stored within the program.

==== list
Shows a list of all patients or medical stored in TeethHub.

Format: `list [dental]`

Command shows patient details by default, add dental to see dental
records.
Command shows patient details by default, add dental to see dental records.

Example:

Expand All @@ -449,14 +481,15 @@ Shows details of all patients.
Shows details of patient's dental records.


=== Find
==== find
Shows patients whose data contains any of the given keywords according to a specified parameter.

Format: `find [dental] PREFIX/KEYWORD [MORE_KEYWORDS]`

* Add “dental” to search dental records instead.
* Search is case insensitive.
* Order of keywords does not matter.
* Valid `Prefix` values: See <<Breakdown of attributes used within TeethHub>>

Example:

Expand All @@ -469,11 +502,14 @@ Show all the people with an address containing the keyword Yishun.
Shows all the dental records with cleaning


=== Sort
==== sort
Sorts the records by an input parameter in an input order.

Format: `sort PARAM ORDER`

* valid PARAM options: address, date of birth, email, name, nric, phone, sex
* valid ORDER options: asce, desc

Example:

[cols=",,,",options="header",]
Expand Down Expand Up @@ -505,19 +541,19 @@ Example:
|2 |Bob |24 |11/02/2019
|===

=== Stat
==== stat
Generates a statistics report based on the specified patient's data.

Format: `stat INDEX`

=== History
=== history
Lists all the commands that have been entered since starting the
application in reverse chronological order.

Format: `history`


=== Undo
=== undo
Undo the latest command.

Format: `undo`
Expand All @@ -542,7 +578,7 @@ previously.
`undo` (reverses the clear command) +
`undo` (reverses the delete 1 command)

=== Redo
=== redo
Reverses the most recent undo command.

Format: `redo`
Expand All @@ -565,20 +601,20 @@ previously.
`redo` (reapplies the delete 1 command) +
`redo` (reapplies the clear command)

=== Clear
=== clear
Clears all patients and records from TeethHub.

* You will be prompted to confirm.
* Input `y` to proceed to the clear all records or `n` to abort.

Format: `clear`

=== Exit
=== exit
Exits the program. You won't be able to exit if copies exist.

Format: `exit`

=== Exit anyway
=== exit anyway
Exits the program, disregarding any copies.

Format: `exit!`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ public Command parseCommand(String userInput) throws ParseException {
throw new ParseException(String.format(MESSAGE_INVALID_COMMAND_FORMAT, HelpCommand.MESSAGE_USAGE));
}

final String commandWord = matcher.group("commandWord").toLowerCase();
final String commandWord = matcher.group("commandWord");
final String arguments = matcher.group("arguments");
switch (commandWord) {
case AddCommand.COMMAND_WORD:
Expand Down
2 changes: 1 addition & 1 deletion src/main/resources/view/StatWindow.fxml
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@
<?import javafx.scene.control.TableView?>
<?import javafx.scene.control.TableColumn?>
<fx:root type="javafx.stage.Stage" xmlns="http://javafx.com/javafx/8" xmlns:fx="http//javafx.com/fxm/1"
title="OurTeeth" minWidth="450" minHeight="600" onCloseRequest="#handleExit">
title="TeethHub" minWidth="450" minHeight="600" onCloseRequest="#handleExit">
<icons>
<Image url="@/images/address_book_32.png" />
</icons>
Expand Down
8 changes: 4 additions & 4 deletions src/test/java/systemtests/AddressBookSystemTest.java
Original file line number Diff line number Diff line change
Expand Up @@ -172,10 +172,10 @@ protected void deleteAllPersons() {
*/
protected void assertApplicationDisplaysExpected(String expectedCommandInput, String expectedResultMessage,
Model expectedModel) {
//assertEquals(expectedCommandInput, getCommandBox().getInput());
//assertEquals(expectedResultMessage.trim(), getResultDisplay().getText().trim());
//assertEquals(new AddressBook(expectedModel.getAddressBook()), testApp.readStorageAddressBook());
//assertListMatching(getPersonListPanel(), expectedModel.getFilteredPersonList());
assertEquals(expectedCommandInput, getCommandBox().getInput());
assertEquals(expectedResultMessage.trim(), getResultDisplay().getText().trim());
assertEquals(new AddressBook(expectedModel.getAddressBook()), testApp.readStorageAddressBook());
assertListMatching(getPersonListPanel(), expectedModel.getFilteredPersonList());
}

/**
Expand Down

0 comments on commit fa16043

Please sign in to comment.