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

[bljhty] iP #65

Open
wants to merge 36 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
a14a728
Update Duke.java
bljhty Aug 26, 2023
cbd58cc
Level 0 increment, edited code
bljhty Aug 27, 2023
b5b91a4
Level 1
bljhty Aug 29, 2023
82224dd
Completed Level 2 increment and updated code
bljhty Aug 29, 2023
59939a7
Added Task.java file,
bljhty Aug 30, 2023
8b1d144
edited code
bljhty Sep 4, 2023
cdbc6b6
level-4 completed, edited code
bljhty Sep 5, 2023
cb72979
edited code
bljhty Sep 13, 2023
75ddef5
Level-5 increment + edit code
bljhty Sep 13, 2023
41ac331
no message
bljhty Sep 13, 2023
e8ec876
Revert "Level-5 increment + edit code"
bljhty Sep 13, 2023
6515beb
Merge branch 'Branch-Level-5'
bljhty Sep 13, 2023
f50b1a3
changes to code
bljhty Sep 13, 2023
4607c85
Revert "changes to code"
bljhty Sep 13, 2023
4729a1e
edited code
bljhty Sep 13, 2023
6469a2f
included packages
bljhty Sep 13, 2023
f5e82cd
Merge branch 'branch-A-package'
bljhty Sep 13, 2023
9627039
edited code:
bljhty Sep 19, 2023
1bb1859
Level-6 increment done
bljhty Sep 19, 2023
39957f7
added level-7 increments
bljhty Sep 20, 2023
c5f0139
Merge branch 'branch-level-6'
bljhty Sep 20, 2023
352ca3b
Merge branch 'branch-level-7'
bljhty Sep 20, 2023
638e421
edited code
bljhty Sep 20, 2023
9119029
edited some code
bljhty Sep 30, 2023
85aaecb
edited code, increment: A-MoreOOP done
bljhty Sep 30, 2023
614e4d6
edited code
bljhty Sep 30, 2023
23e63d4
Level-9 increment done
bljhty Sep 30, 2023
d89ca68
Merge pull request #2 from bljhty/branch-Level-9
bljhty Sep 30, 2023
aba7f13
Merge branch 'master' of https://github.com/bljhty/ip
bljhty Sep 30, 2023
fe6c10e
added javadoc
bljhty Sep 30, 2023
a99d632
improved code, added readme
bljhty Sep 30, 2023
7a6474b
added more javaDoc
bljhty Sep 30, 2023
e9b75a3
Merge pull request #3 from bljhty/branch-A-JavaDoc
bljhty Sep 30, 2023
1f20765
added changes to userguide
bljhty Sep 30, 2023
d6cede0
Merge pull request #4 from bljhty/branch-A-UserGuide
bljhty Sep 30, 2023
4814f11
refactored code and make changes to code
bljhty Oct 3, 2023
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
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,4 @@ bin/

/text-ui-test/ACTUAL.TXT
text-ui-test/EXPECTED-UNIX.TXT
*.class
109 changes: 94 additions & 15 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,108 @@
# User Guide
# DOM User Guide
Dom is a desktop program to store a list of tasks for the user via a Command Line Interface(CLI)

## Quick Start
1. Ensure that you have JAVA '11' or above installed in your computer.
2. Download the latest 'ip.jar' from [here](https://github.com/bljhty/ip/releases)
3. Copy downloaded 'ip.jar' file to the desired home folder of your choice
4. open a command terminal and 'cd' to the folder mentioned in ster 3
5. type in the following to run the application

```
java -jar ip.jar
```

6. if successful, the following greeting should appear:
```
Hello from
____
| _ \ ___ _ __ ___
| | | |/ _ \| '_ ` _ \
| |_| | (_) | | | | | |
|____/ \___/|_| |_| |_|

____________________________________________________________
Hello! I'm Dom
What can I do for you?
```
7. Type in desired command to start using the program.

## Features
### Adding a todo task: `todo`
Adds a task of type todo to the list.
<br>Todo contains a description.

### Feature-ABC
Format: `todo DESCRIPTION`
<br>Example: `todo read book`

Description of the feature.
### Adding an event: `event`
Adds a task of type event to the list.
<br>Event contains a description, from and to.

### Feature-XYZ
Format: `event DESCRIPTION /from FROM /to TO`
<br>Example: `event CS2113 tutorial /from 4 April 2023 4pm /to 6pm`

Description of the feature.

## Usage
### Adding a deadline: `deadline`
Adds a task deadline to the list.
<br>Deadline contains description and by.

### `Keyword` - Describe action
Format: `deadline DESCRIPTION /by BY`
<br>Example: `deadline CS2113 iP /by 3 March 11.59pm`

Describe the action and its outcome.
### Viewing full list of tasks: `list`
Shows a list of all tasks recorded in the list.

Example of usage:
Format: `list`

`keyword (optional arguments)`
### Mark task as done: `mark`
Marks task as done based on the task number indicated.

Expected outcome:
Format: `mark TASK_NUMBER`
- TASK_NUMBER must be an integer that is within the list size

Description of the outcome.
Example: `mark 2`

```
expected output
```
### Mark task as not done: `unmark`
Marks task as not done based on the task number indicated.

Format: `unmark TASK_NUMBER`
- TASK_NUMBER must be an integer that is within the list size

Example: `unmark 3`

### Delete task: `delete`
Deletes the task based on the task number indicated.

Format: `delete TASK_NUMBER`
- TASK_NUMBER must be an integer that is within the list size

Example: `delete 1`

### Find task(s): `find`
Searches the tasks in the list, returning the tasks containing the keyword in their description.

Format: `find KEYWORD`
<br>Example: `find CS2113`

### Exiting DOM: `bye`
Exits and closes the program.

Format: `bye`

## FAQ
**Q**: Can I edit the file manually from the save.txt file?
<br>**A**: It is not advised to do so, as formatting of the save.txt file incorrectly will cause the program to crash.

## Command Summary
| **Command** | **Format, Examples** |
|-------------|------------------------------------------------------------------------------------------------------|
| todo | `todo DESCRIPTION`<br>e.g. `todo read book` |
| event | `event DESCRIPTION /from FROM /to TO`<br>e.g. `event CS2113 tutorial /from 4 April 2023 4pm /to 6pm` |
| deadline | `deadline DESCRIPTION /by BY`<br>e.g. `deadline CS2113 iP /by 3 March 11.59pm` |
| list | `list` |
| mark | `mark TASK_NUMBER`<br>e.g. `mark 2` |
| unmark | `unmark TASK_NUMBER`<br>e.g. `unmark 3` |
| delete | `delete TASK_NUMBER`<br>e.g. `delete 1` |
| find | `find KEYWORD`<br>e.g. `find CS2113` |
| bye | `bye` |
Loading