Skip to content
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

[Tan De Jun] iP #49

Open
wants to merge 46 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
5f95754
Add Increment Level-0
Jan 21, 2020
1712ba3
Added Increment Level-1
Jan 28, 2020
7fb8c64
Added Increment Level-2
Jan 28, 2020
0fa791d
Added Increment Level-3
Jan 29, 2020
9ebec4f
Added Increment A-CodingStandard
Jan 29, 2020
808dd99
Added Increment Level-4
Feb 3, 2020
eeca7c6
Added Increment A-CodeQuality
Feb 3, 2020
ae39535
Added Increment Level-5
Feb 11, 2020
0fa09b7
Merge branch 'branch-Level-5'
Feb 11, 2020
7cfffd6
Added Increment Level-6
Feb 18, 2020
f4a1fbb
Added Increment Level-7
Feb 18, 2020
3554da1
Merge branch 'branch-Level-6'
Feb 18, 2020
0dc3469
Merge branch 'branch-Level-7'
Feb 18, 2020
4d4126c
Added Increment A-Packages
Feb 25, 2020
0cbd22a
Improved Coding Standard
Feb 25, 2020
8d1e543
Added Increment A-MoreOOP and redid code base
Feb 28, 2020
6a37f65
Added Increment Level-8
Feb 28, 2020
d060ea5
Added Increment Level-9
Feb 28, 2020
29129c1
Added Help, Clear commands and minor improvements
Feb 28, 2020
cbf32ad
Made minor file name changes
Feb 28, 2020
c11c116
Minor edits to saving and created separate branch for Level 9
Feb 29, 2020
88f65f2
Merge branch 'branch-Level-9'
Feb 29, 2020
426bff3
Created separate branch-Level-8
Feb 29, 2020
50bac83
Merge branch 'branch-Level-8'
Feb 29, 2020
7534af4
Created separate branch-A-Packages and fixed storage issues
Mar 1, 2020
1c2046e
Merge branch 'branch-A-Packages'
Mar 1, 2020
b29a35b
Added Increment A-UserGuide
Mar 1, 2020
3684676
Made improvements to code and updated User Guide
Mar 1, 2020
cd3fccb
Set theme jekyll-theme-cayman
dejunnn Mar 1, 2020
3e4eb42
Fixed minor bug in User Guide deployment
Mar 1, 2020
c4a2467
Set theme jekyll-theme-cayman
dejunnn Mar 1, 2020
27ef2aa
Merge branch 'master' of https://github.com/dejunnn/duke
Mar 1, 2020
c635d8e
Fixed minor bug in User Guide Deployment and created branch-A-UserGuide
Mar 1, 2020
0c9c87f
Added Increment A-JavaDoc and added branch-A-JavaDoc
Mar 1, 2020
8478ec1
Updated JavaDocs
Mar 1, 2020
55607ae
Merge pull request #2 from dejunnn/branch-A-JavaDoc
dejunnn Mar 1, 2020
48c57d4
Merge branch 'master' into branch-A-UserGuide
Mar 1, 2020
8baa5e6
Merge pull request #3 from dejunnn/branch-A-UserGuide
dejunnn Mar 1, 2020
36f888a
Prepared Duke for release
Mar 1, 2020
ea7f375
Fixed minor bug with data saving
Mar 1, 2020
ae18673
Generated JavaDocs
Mar 2, 2020
72bc202
Reformatted Code
Mar 3, 2020
32ae5fb
Updated User Guide
Mar 3, 2020
54ec84a
Updated User Guide
Mar 3, 2020
424ba05
Updated User Guide
Mar 3, 2020
aae995d
Updated User Guide
Mar 3, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,11 @@

# Tutorials

Duke Increment | Tutorial
duke.Duke Increment | Tutorial
---------------|---------------
`A-Gradle` | [Gradle Tutorial](tutorials/gradleTutorial.md)
`A-TextUiTesting` | [Text UI Testing Tutorial](tutorials/textUiTestingTutorial.md)
`Level-10` | JavaFX tutorials:<br>→ [Part 1: Introduction to JavaFX][fx1]<br>→ [Part 2: Creating a GUI for Duke][fx2]<br>→ [Part 3: Interacting with the user][fx3]<br>→ [Part 4: Introduction to FXML][fx4]
`Level-10` | JavaFX tutorials:<br>→ [Part 1: Introduction to JavaFX][fx1]<br>→ [Part 2: Creating a GUI for duke.Duke][fx2]<br>→ [Part 3: Interacting with the user][fx3]<br>→ [Part 4: Introduction to FXML][fx4]

[fx1]: <tutorials/javaFxTutorialPart1.md>
[fx2]: <tutorials/javaFxTutorialPart2.md>
Expand Down
1 change: 1 addition & 0 deletions _config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
theme: jekyll-theme-cayman
Empty file added data/duke.txt
Empty file.
263 changes: 253 additions & 10 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,263 @@
# User Guide

## Features
## Content
1. [Introduction](#1-introduction)
2. [Download](#2-download)
3. [Features](#3-features)
1. [Add a task](#add-a-task)
2. [Delete a task](#delete-a-task)
3. [Mark task as done](#mark-task-as-done)
4. [View task list](#view-task-list)
5. [Clear task list](#clear-task-list)
6. [Find a task](#find-a-task)
7. [View help menu](#view-help-menu)
8. [Exit Program](#exit-program)
4. [Summary](#4-summary)

### Feature 1
Description of feature.

## Usage
## 1. Introduction

### `Keyword` - Describe action
Duke is a personal text-based chat-bot application used for managing tasks.
Duke is capable of handling 3 different types of tasks:
* _**ToDo**_ (Consists of a short description) <br>
* _**Deadline**_ (Consists of a short description and task deadline details) <br>
* _**Event**_ (Consists of a short description and task location details) <br>

Describe action and its outcome.
## 2. Download

* Ensure that you have Java 11 or above installed in your Computer. <br>
* Download the latest version of duke.jar [here](https://github.com/dejunnn/duke/releases). <br>
* Open and run the duke.jar file. <br>
* Duke will store task list data as a "duke.txt" file in the "data" directory. <br>


Example of usage:
If there is no directory present, Duke will create one upon startup. Duke will also create an empty duke.txt file. <br>

__________________________________________________________________________________________
New Directory created: data
No existing file is found, new file created: duke.txt
__________________________________________________________________________________________

`keyword (optional arguments)`
If there is an existing directory and duke.txt file present, Duke will load existing data from the file. <br>

__________________________________________________________________________________________
File already exists. Existing data loaded from: duke.txt
__________________________________________________________________________________________

Expected outcome:
The following text-based user interface should be displayed: <br>

__________________________________________________________________________________________
____ _
| _ \ _ _| | _____
| | | | | | | |/ / _ \
| |_| | |_| | < __/
|____/ \__,_|_|\_\___|

Hello! I'm Duke. What can I do for you?
Type /help for a list of supported commands.
__________________________________________________________________________________________

## 3. Features

### Add a task
This command creates a new task and adds it to the task list.

#### Usage
* Add new ToDo: `todo description` <br>
* Add new Deadline: `deadline description /by deadline` <br>
* Add new Event: `event description /at location` <br>

**Example of usage:** <br>
> `todo project` <br>
> `deadline project-report /by 2020-05-18` <br>
> `event project-meeting /at nus-clb` <br>

**Expected outcome:** <br>
The respective tasks will be created and added to the task list.

todo project
__________________________________________________________________________________________
Noted! I have added a new todo.
[T] [X] project
You now have 1 tasks in the list.
__________________________________________________________________________________________
deadline project-report /by 2020-05-18
__________________________________________________________________________________________
Noted! I have added a new deadline.
[D] [X] project-report (by: 18 May 2020)
You now have 2 tasks in the list.
__________________________________________________________________________________________
event project-meeting /at nus-clb
__________________________________________________________________________________________
Noted! I have added a new event.
[E] [X] project-meeting (at: nus-clb)
You now have 3 tasks in the list.
__________________________________________________________________________________________


### Delete a task
This command deletes a task from the task list depending on the specified index.

#### Usage
* Delete task at specified index: `delete index`

**Example of usage:** <br>
> `delete 3`

**Expected outcome:** <br>
The task at the specified index will be deleted from the list.

delete 3
__________________________________________________________________________________________
Got it! The following task has been successfully deleted:
[E] [X] project-meeting (at: nus-clb)
__________________________________________________________________________________________

### Mark task as done
This command marks a task as done depending on the specified index.

#### Usage
* Mark task as done at specified index: `done index`

**Example of usage:** <br>
> `done 2`

**Expected outcome:** <br>
The task at the specified index will be marked as done.

done 2
__________________________________________________________________________________________
Great! I have marked this task as done.
[D] [/] project-report (by: 18 May 2020)
__________________________________________________________________________________________

### View task list
This command displays the current task list.

#### Usage
* Display task list: `list`

**Example of usage:** <br>
> `list`

**Expected outcome:** <br>
All tasks in the task list will be displayed according to their current index.

list
__________________________________________________________________________________________
Here are the tasks in your list:
1. [T] [X] project
2. [D] [/] project-report (by: 18 May 2020)
__________________________________________________________________________________________

### Clear task list
This command clears the current task list.

#### Usage
* Clear task list: `clear`

**Example of usage:** <br>
> `clear`

**Expected outcome:** <br>
All tasks in the task list will be cleared after second confirmation by the user.

clear
__________________________________________________________________________________________
Are you sure you want to clear all tasks in your list? Type 'Y' to confirm.
__________________________________________________________________________________________
Y
__________________________________________________________________________________________
Your task list has been cleared successfully!
__________________________________________________________________________________________


clear
__________________________________________________________________________________________
Are you sure you want to clear all tasks in your list? Type 'Y' to confirm.
__________________________________________________________________________________________
N
__________________________________________________________________________________________
You task list has not been cleared.
__________________________________________________________________________________________


### Find a task
This command performs a search of all tasks currently in the task list and displays
a list of all tasks that contains a specified substring in the description.

#### Usage
* Find task using substring: `find substring`

**Example of usage:** <br>
> `find report`

**Expected outcome:** <br>
All matching tasks in the task list will be displayed in a numbered list.

find report
__________________________________________________________________________________________
Here are the matching tasks in your list:
1. [D] [/] project-report (by: 18 May 2020)
__________________________________________________________________________________________

### View help menu
This command displays the list of commands supported by the application.

#### Usage
* Display help menu: `/help`

**Example of usage:** <br>
> `/help`

**Expected outcome:** <br>
The list of all commands supported by the application will be displayed.

/help
__________________________________________________________________________________________
The following commands are supported by Duke:

To add a ToDo, enter: todo description
To add a Deadline, date in yyyy-mm-dd or otherwise, enter: deadline /by date
To add an Event, enter: event /at location
To find a task from a substring, enter: find substring
To delete a task from your task list with its index, enter: delete index
To mark a task as done with its index, enter: done index
To display your task list, enter: list
To clear your task list, enter: clear
To display the help list, enter: /help
To exit the programme, enter: bye

__________________________________________________________________________________________

### Exit Program
This command is used to exit the application.

#### Usage
* Exit program: `bye`

**Example of usage:** <br>
> `bye`

**Expected outcome:** <br>
The application will terminate.

__________________________________________________________________________________________
Goodbye. Hope to see you again soon!
__________________________________________________________________________________________

## 4. Summary

No. | Command | Description
----| ------- | -----------
1 | `todo description` | Add new ToDo
2 | `deadline description /by deadline` | Add new Deadline
3 | `event description /at location` | Add new Event
4 | `delete index` | Delete task
5 | `done index` | Mark task as done
6 | `list` | Display task list
7 | `clear` | Clear task list
8 | `find substring` | Find task
9 | `/help` | Display help menu
10 | `bye` | Exit program

`outcome`
1 change: 1 addition & 0 deletions docs/_config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
theme: jekyll-theme-cayman
Loading