Skip to content

Commit

Permalink
Merge pull request #139 from cadencjk/fix-tp-website
Browse files Browse the repository at this point in the history
Add table of contents to UG and DG
  • Loading branch information
cadencjk authored Oct 15, 2022
2 parents 5d10d44 + 1fa91e4 commit 9f7a251
Show file tree
Hide file tree
Showing 2 changed files with 69 additions and 11 deletions.
21 changes: 16 additions & 5 deletions docs/DeveloperGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,19 @@
layout: page
title: Developer Guide
---
* Table of Contents
{:toc}

## Table of contents
* [Target User Profile](#target-user-profile)
* [Value Proposition](#value-proposition)
* [User Stories](#user-stories)
* [Use Case](#use-case)
* [Use case: **Delete a student**](#use-case-delete-a-student)
* [Use case: **Edit a student contact detail**](#use-case-edit-a-student-contact-detail)
* [Use case: **Find student contact details**](#use-case-find-student-contact-details)
* [Use case: **Mark student as present for class**](#use-case-mark-student-as-present-for-class)
* [Use case: **Allocate a slot for future class**](#use-case-allocate-a-slot-for-future-class)
* [Non-Functional Requirement](#non-functional-requirement)
* [Glossary](#glossary)

--------------------------------------------------------------------------------------------------------------------
## Target User Profile
Expand Down Expand Up @@ -82,7 +93,7 @@ Manage contacts and schedule of students faster than a typical mouse/GUI driven
Use case resumes at step 2.

[](#use-case-edit-a-student-contact-detail)
### Use case: Edit a student contact detail
### Use case: **Edit a student contact detail**

**MSS**

Expand Down Expand Up @@ -124,7 +135,7 @@ Manage contacts and schedule of students faster than a typical mouse/GUI driven

Use case ends.

### Use case: Mark student as present for class**
### Use case: **Mark student as present for class**

**MSS**

Expand Down Expand Up @@ -153,7 +164,7 @@ Manage contacts and schedule of students faster than a typical mouse/GUI driven

Use case resumes at step 2.

### Use case: Allocate a slot for future class
### Use case: **Allocate a slot for future class**

**MSS**

Expand Down
59 changes: 53 additions & 6 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,22 @@ Teacher’s Pet is a desktop application for managing contacts of students and c
Command Line Interface (CLI) while still having the benefits of a Graphical User Interface (GUI). If you can type fast,
Teacher’s Pet can get your contact and class management tasks done faster than traditional GUI apps.

* Table of Contents
{:toc}
## Table of contents
* [Quick Start](#quick-start)
* [UI Overview](#ui-overview)
* [Features](#features)
* [Viewing help: `help`](#viewing-help-help)
* [Adding a student: `add`](#adding-a-student-add)
* [Editing student details: `edit`](#editing-student-details-edit)
* [Viewing all students: `list`](#viewing-all-students-list)
* [Finding a student: `find`](#finding-a-student-find)
* [Deleting a student: `delete`](#deleting-a-student-delete)
* [Clearing all student: `clear`](#clearing-all-student-clear)
* [Exiting the program : `exit`](#exiting-the-program-exit)
* [Saving the data](#saving-the-data)
* [Editing the data file](#editing-the-data-file)
* [FAQ](#faq)
* [Command Summary](#command-summary)

--------------------------------------------------------------------------------------------------------------------

Expand Down Expand Up @@ -47,6 +61,8 @@ Basic Instructions:
- `exit`: Exits the app.
2. Refer to the Features below for details of each command.

[Back to top](#table-of-contents)

---

## Features
Expand All @@ -65,17 +81,18 @@ Basic Instructions:
- Extraneous parameters for commands that do not take in parameters (such as `help`, `list`, `exit` and `clear`) will
be ignored. e.g. if the command specifies `help 123`, it will be interpreted as `help`.

### Viewing help : `help`
### Viewing help: `help`

Shows a message explaining how to access the help page.

Format: `help`

![Help](images/UiHelp.png)

[Back to top](#table-of-contents)

---

[](#adding-a-studentadd)
### Adding a student: `add`

Adds a student to the Teacher’s Pet.
Expand Down Expand Up @@ -134,6 +151,8 @@ Example:
Note: Amount paid, Amount owed, Additional notes fields are to be updated via `edit` command.
```

[Back to top](#table-of-contents)

---

### Editing student details: `edit`
Expand Down Expand Up @@ -181,7 +200,10 @@ Example:

![UiEdit](images/UiEdit.png)

[Back to top](#table-of-contents)

---

### Viewing all students: `list`

Allows the user to view students and their information which includes:
Expand All @@ -199,8 +221,11 @@ Format: `list`

![UiUList](images/UiList.png)

[Back to top](#table-of-contents)

---
### Finding a student : `find`

### Finding a student: `find`

Finds students whose names contain any of the given keywords.

Expand All @@ -218,7 +243,10 @@ Example:

![UiFind](images/UiFind.png)

[Back to top](#table-of-contents)

---

### Deleting a student: 'delete'

Deletes the specified person from the student list.
Expand All @@ -237,7 +265,10 @@ Examples:
❗ Caution: Deleting a student is irreversible! Please ensure the correct index number.
```

[Back to top](#table-of-contents)

---

### Clearing all student: 'clear'

Clears all students and their details from the list.
Expand All @@ -248,17 +279,28 @@ Format: `clear`
❗ Caution: Clearing all students is irreversible!
```

[Back to top](#table-of-contents)

---
### Exiting the program : `exit`

### Exiting the program: `exit`

Exits the program.

Format: `exit`

[Back to top](#table-of-contents)

---

### Saving the data

Teacher’s Pet data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually.

[Back to top](#table-of-contents)

---

### Editing the data file

Students' data is saved as a JSON file `[JAR file location]/data/addressbook.json`. Advanced users are welcome to edit the data file.
Expand All @@ -267,6 +309,8 @@ Students' data is saved as a JSON file `[JAR file location]/data/addressbook.jso
❗ Caution: If your changes to the data file makes its format invalid, Teacher’s Pet will discard all data and start with an empty data file at the next run.
```

[Back to top](#table-of-contents)

---

## FAQ
Expand All @@ -275,6 +319,8 @@ Q: How do I transfer my data to another Computer?

A: Install the app in the other computer and overwrite the empty data file it creates with the file that contains the data of your previous Teacher's Pet home folder.

[Back to top](#table-of-contents)

---

## Command summary
Expand All @@ -290,3 +336,4 @@ A: Install the app in the other computer and overwrite the empty data file it cr
| Clear all students | `clear` |
| Exit the application | `exit` |

[Back to top](#table-of-contents)

0 comments on commit 9f7a251

Please sign in to comment.