Skip to content

Commit

Permalink
Update User Guide
Browse files Browse the repository at this point in the history
  • Loading branch information
Joshuahoky committed Apr 1, 2024
1 parent ffdb391 commit 60baef5
Showing 1 changed file with 140 additions and 17 deletions.
157 changes: 140 additions & 17 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,156 @@
# User Guide
# BookBuddy User Guide

## Introduction
## Overview

{Give a product intro}
BookBuddy is an application that helps users track and manage the list of books
that they are reading. It is optimised for users that are familiar with the CLI so that
the tracking and management objectives can be achieved more efficiently.

## Quick Start

{Give steps to get started quickly}
## Getting Started

1. Ensure that you have Java 11 or above installed.
1. Down the latest version of `Duke` from [here](http://link.to/duke).
2. Download the latest JAR file of BookBuddy [here](https://github.com/AY2324S2-CS2113-F15-4/tp/releases).
3. Move the JAR file into an empty folder.
4. In any command terminal, use the `cd` command to switch to the folder containing the JAR file.
5. Enter `java -jar BookBuddy.jar` in the command terminal to run the application.
6. Refer to the features below for details of the various commands and how to use BookBuddy.

## Features

### Adding a book: `help`
View all the commands available in BookBuddy and instructions on their formatting.

Format: `help`

Example of usage:

```
help
```

### Adding a book: `add`
Adds a new book to the book list.

Format: `add [BOOK_TITLE]`

Example of usage:

```
add Harry Potter
```

### Removing a book: `remove`
Removes a specific book from the book list.

Format: `remove [BOOK_INDEX]`

Example of usage:

```
remove 1
```

### Viewing all books: `list`
Shows all books in the list along with their titles and status.

Format: `list`

Example of usage:

```
list
```

### Marking a book as read: `mark`
Changes the status of a specific book to read.

Format: `mark [BOOK_INDEX]`

Example of usage:

```
mark 1
```

### Marking a book as unread: `unmark`
Changes the status of a specific book to unread.

Format: `unmark [BOOK_INDEX]`

Example of usage:

```
unmark 1
```

### Setting the genre of a book: `set-genre`

Sets the genre of a specific book to the provided input.

Format: `set-genre [BOOK_INDEX] [BOOK_GENRE]`

Example of usage:

```
set-genre 1 fiction
```

### Labelling a book: `label`

Sets the label of a specific book to the provided input.

Format: `label [BOOK_INDEX] [LABEL]`

Example of usage:

```
label 1 very cool
```

### Adding a book summary: `give-summary`
Provides a summary for the specified book.

Format: `give-summary [BOOK_INDEX] [BOOK_SUMMARY]`

Example of usage:

```
give-summary 1 A book about a young boy who is invited to study at Hogwarts.
```

### Displaying the details of a book: `display`
Gives more detailed information about a specific book like its genre, label and summary.

Format: `display [BOOK_INDEX]`

Example of usage:

```
display 1
```

### Finding a book: `find`
Returns all books in the book list that contains the keyword.

## Features
Format: `find [KEYWORD]`

{Give detailed description of each feature}
Example of usage:

### Adding a todo: `todo`
Adds a new item to the list of todo items.
```
find harry
```

Format: `todo n/TODO_NAME d/DEADLINE`
### Exiting the program: `bye`

* The `DEADLINE` can be in a natural language format.
* The `TODO_NAME` cannot contain punctuation.
Exits the application.

Example of usage:
Format: `bye`

`todo n/Write the rest of the User Guide d/next week`
Example of usage:

`todo n/Refactor the User Guide to remove passive voice d/13/04/2020`
```
bye
```

## FAQ

Expand Down

0 comments on commit 60baef5

Please sign in to comment.