Skip to content

Commit

Permalink
Merge pull request #42 from jiayushe/ugdg
Browse files Browse the repository at this point in the history
Update User Guide and Other Miscellaneous Stuff
  • Loading branch information
le0tan authored Sep 30, 2019
2 parents 8cf90fa + d52dd5c commit ff8d958
Show file tree
Hide file tree
Showing 5 changed files with 25 additions and 24 deletions.
1 change: 1 addition & 0 deletions README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
ifdef::env-github,env-browser[:relfileprefix: docs/]

https://travis-ci.org/AY1920S1-CS2103T-W11-1/main[image:https://travis-ci.org/AY1920S1-CS2103T-W11-1/main.svg?branch=master[Build Status]]
https://coveralls.io/github/AY1920S1-CS2103T-W11-1/main?branch=master[image:https://coveralls.io/repos/github/AY1920S1-CS2103T-W11-1/main/badge.svg?branch=master[Coverage Status]]

ifdef::env-github[]
image::docs/images/Ui.png[width="600"]
Expand Down
4 changes: 2 additions & 2 deletions build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -133,8 +133,8 @@ asciidoctor {
idprefix: '', // for compatibility with GitHub preview
idseparator: '-',
'site-root': "${sourceDir}", // must be the same as sourceDir, do not modify
'site-name': 'AddressBook-Level3',
'site-githuburl': 'https://github.com/se-edu/addressbook-level3',
'site-name': 'AlgoBase',
'site-githuburl': 'https://github.com/AY1920S1-CS2103T-W11-1/main',
'site-seedu': true, // delete this line if your project is not a fork (not a SE-EDU project)
]

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

AlgoBase was developed by the https://se-edu.github.io/docs/Team.html[se-edu] team. +
AlgoBase was developed by Team https://github.com/orgs/AY1920S1-CS2103T-W11-1/people[Team CS2103T-W11-1]. +
{empty} +
We are a team based in the http://www.comp.nus.edu.sg[School of Computing, National University of Singapore].

Expand Down
2 changes: 1 addition & 1 deletion docs/DeveloperGuide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -604,7 +604,7 @@ These instructions only provide a starting point for testers to work on; testers
.. Test case: `delete 1` +
Expected: First contact is deleted from the list. Details of the deleted contact shown in the status message. Timestamp in the status bar is updated.
.. Test case: `delete 0` +
Expected: No person is deleted. Error details shown in the status message. Status bar remains the same.
Expected: No problem is deleted. Error details shown in the status message. Status bar remains the same.
.. Other incorrect delete commands to try: `delete`, `delete x` (where x is larger than the list size) _{give more}_ +
Expected: Similar to previous.

Expand Down
40 changes: 20 additions & 20 deletions docs/UserGuide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ e.g. typing *`help`* and pressing kbd:[Enter] will open the help window.
. Some example commands you can try:

* *`list`* : lists all problems
* **`add`**`n/factorial m/define a function factorial that takes in a number and n and returns the factorial of the number t/recursion a/Wee Han` : adds a problem called 'factorial' tagged with 'recursion' and authored by 'Wee Han'
* **`add`**`n/factorial d/define a function factorial that takes in a number and n and returns the factorial of the number t/recursion a/Wee Han` : adds a problem called 'factorial' tagged with 'recursion' and authored by 'Wee Han'
* *`exit`* : exits the app

. Refer to <<Features>> for details of each command.
Expand All @@ -56,14 +56,14 @@ e.g. typing *`help`* and pressing kbd:[Enter] will open the help window.
==== Adding a problem: `add`

Generates a new problem. +
Format: `add n/NAME [m/DESCRIPTION] [a/AUTHOR] [t/TAG]...`
Format: `add n/NAME [d/DESCRIPTION] [a/AUTHOR] [t/TAG]...`

[TIP]
A problem can have any number of tags (including 0)

Examples:

* `add n/factorial m/define a function factorial that takes in a number n and returns the factorial of the number t/recursion a/Wee Han`
* `add n/factorial d/define a function factorial that takes in a number n and returns the factorial of the number t/recursion a/Wee Han`

==== Listing all problems : `list`

Expand All @@ -73,7 +73,7 @@ Format: `list`
==== Editing a problem : `edit`

Edits an existing problem. +
Format: `edit n/NAME [d/DELETE] [n/NAME] [m/DESCRIPTION] [a/AUTHOR] [t/TAG]...`
Format: `edit INDEX [d/DELETE] [n/NAME] [d/DESCRIPTION] [a/AUTHOR] [t/TAG]...`

* Edits the problem at the specified `INDEX`. The index refers to the index number shown in the displayed problem list. The index *must be a positive integer* 1, 2, 3, ...
* At least one of the optional fields must be provided.
Expand All @@ -93,11 +93,11 @@ Edits the name of the 2nd problem to be `permutations` and clears all existing t
Finds problems whose names contain any of the given keywords. +
Format: `find KEYWORD [MORE_KEYWORDS]`

* The search is case insensitive. e.g `hans` will match `Hans`
* The order of the keywords does not matter. e.g. `Hans Bo` will match `Bo Hans`
* The search is case insensitive. e.g `henz` will match `Henz`
* The order of the keywords does not matter. e.g. `Henz Martin` will match `Martin Henz`
* Only the name is searched.
* Only full words will be matched e.g. `Han` will not match `Hans`
* Problems matching at least one keyword will be returned (i.e. `OR` search). e.g. `Hans Bo` will return `Hans Gruber`, `Bo Yang`
* Only full words will be matched e.g. `Hen` will not match `Henz`
* Problems matching at least one keyword will be returned (i.e. `OR` search). e.g. `Henz Ben` will return `Henz Martin`, `Ben Leong`

Examples:

Expand Down Expand Up @@ -125,31 +125,31 @@ Deletes the 2nd problem in the displayed list.
Deletes the 1st problem in the results of the `find` command.


==== Sorting problem: `sort`
==== Sorting problems: `sort`

Sorts the current list of results by a specified order and direction. +
Format: `sort m/METHOD [d/DIRECTION]`

* Method can be `alphabetical` or `chronological`.
* Method can be `alphabetical`, `chronological` or `difficulty`.
* Direction can be `ASC` or `DESC` representing ascending and descending order. The default is in ascending order.

=== Tags

==== Create new tags: `newtag`
==== Creating new tags: `newtag`

Generates a new tag. +
Format: `newtag n/NAME`

Examples:

* `newtag n/sssp`
* `newtag n/sssp`

==== Listing tags: `lstag`

Displays a list of all existing tags. +
Format: `lstag`

==== Create new tags: `deletetag`
==== Deleting new tags: `deletetag`

Deletes an existing tag. +
Format: `deletetag INDEX`
Expand All @@ -171,11 +171,11 @@ Examples:
==== Editing a training plan `editplan`

Edits an existing training plan. +
Format: `editplan INDEX [a/ADD_PROBLEM_INDEX_LIST] [r/DELETE_PROBLEM_INDEX_LIST] [n/NAME]`
Format: `editplan INDEX [a/ADD_PROBLEM_INDEX_LIST] [d/DELETE_PROBLEM_INDEX_LIST] [n/NAME]`

Examples:

* `editplan 1 a/1 2 3 r/4 5 6 n/training set 1`
* `editplan 1 a/1 2 3 d/4 5 6 n/training set 1`

==== Locating training plans by name: `findplan`

Expand Down Expand Up @@ -271,10 +271,10 @@ There is no need to save manually.

== Command Summary

* *Add* `add n/NAME [m/DESCRIPTION] [a/AUTHOR] [t/TAG]...` +
e.g. `add n/factorial m/define a function factorial that takes in a number n and returns the factorial of the number t/recursion a/Wee Han`
* *Add* `add n/NAME [d/DESCRIPTION] [a/AUTHOR] [t/TAG]...` +
e.g. `add n/factorial d/define a function factorial that takes in a number n and returns the factorial of the number t/recursion a/Wee Han`
* *List* : `list` +
* *Edit* : `edit n/NAME [d/DELETE] [n/NAME] [m/DESCRIPTION] [a/AUTHOR] [t/TAG]...` +
* *Edit* : `edit INDEX [d/DESCRIPTION] [a/AUTHOR] [t/TAG]...` +
e.g. `edit 2 n/permutations t/`
* *Find* : `find KEYWORD [MORE_KEYWORDS]` +
e.g. `find factorial permutations`
Expand All @@ -291,8 +291,8 @@ e.g. `deletetag 3`

* *Add Training Plan* : `addplan n/NAME` +
e.g. `addplan n/CS2040`
* *Edit Training Plan* : `editplan INDEX [a/ADD_PROBLEM_INDEX_LIST] [r/DELETE_PROBLEM_INDEX_LIST] [n/NAME]` +
e.g. `editplan 1 a/1 2 3 r/4 5 6 n/training set 1`
* *Edit Training Plan* : `editplan INDEX [a/ADD_PROBLEM_INDEX_LIST] [d/DELETE_PROBLEM_INDEX_LIST] [n/NAME]` +
e.g. `editplan 1 a/1 2 3 d/4 5 6 n/training set 1`
* *Find Training Plan* : `findplan KEYWORD [MORE_KEYWORDS]` +
e.g. `find training set`
* *List Training Plans* : `lsplan`
Expand Down

0 comments on commit ff8d958

Please sign in to comment.