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

[CS2103-F10-2] Bogo Bogo #78

Open
wants to merge 630 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
630 commits
Select commit Hold shift + click to select a range
d3faca1
Implementation for Find
Nov 1, 2021
c15b367
Update usecases
bernarduskrishna Nov 1, 2021
b85b1fa
Implementation for Sort
Nov 1, 2021
935bcc8
Update find feature UML diagram
Nov 1, 2021
f5f45dd
Update sort feature UML diagram
Nov 1, 2021
44abee8
Update design considerations
Nov 1, 2021
ba0afc4
Mutating Inventory
Nov 1, 2021
39b91e7
Fix Errors
Nov 1, 2021
8b51398
Update DG - Order related stuff
bernarduskrishna Nov 1, 2021
e0c5405
Merge pull request #161 from bernarduskrishna/fix-storage-model
GraceWang2322 Nov 2, 2021
3413c51
Fix naming issues
bryanwee023 Nov 2, 2021
c102554
Fix parsing of prices
bryanwee023 Nov 2, 2021
bd20062
Add tests for parsing prices
bryanwee023 Nov 2, 2021
6716faf
Fix parsing issues in find command
bryanwee023 Nov 2, 2021
3f02d7f
Fix styling
bryanwee023 Nov 2, 2021
274a0ea
Update tests
bryanwee023 Nov 2, 2021
ca1e7a3
Fix spelling
bryanwee023 Nov 2, 2021
cbd78b6
Update help links
bryanwee023 Nov 2, 2021
3eca0a9
Merge pull request #165 from bryanwee023/enhance-parsing
bernarduskrishna Nov 2, 2021
c327026
Improve how-to messages
bryanwee023 Nov 2, 2021
aba4aea
Have sorting by name ignore case
bryanwee023 Nov 2, 2021
aeb8323
Merge branch 'master' into Uml-diagrams
bernarduskrishna Nov 2, 2021
6ce470c
Merge pull request #164 from GraceWang2322/Uml-diagrams
bernarduskrishna Nov 2, 2021
4a09f97
Fix window name
bryanwee023 Nov 2, 2021
c59bb4c
Standardise formatting of help messages
bryanwee023 Nov 2, 2021
ee77a35
Fix documentation bugs
bryanwee023 Nov 2, 2021
f222ef2
Merge branch 'master' of github.com:GraceWang2322/tp
Nov 3, 2021
1f1bc91
Merge pull request #167 from bryanwee023/fix-naming
bernarduskrishna Nov 3, 2021
5d3f6b4
Merge pull request #168 from bryanwee023/update-user-guide
bernarduskrishna Nov 3, 2021
a970d73
Error for editing count directly
Nov 3, 2021
c2da7c7
DeleteCommand detects extra flags
Nov 3, 2021
161f4eb
Fix list transaction bugs
bryanwee023 Nov 3, 2021
14b9215
Update tests
bryanwee023 Nov 3, 2021
2cd3d81
Fix AddCommand bugs
Nov 3, 2021
16f2a43
Merge pull request #170 from bryanwee023/fix-list-transactions
bernarduskrishna Nov 3, 2021
e2cc010
Merge pull request #171 from GraceWang2322/Fix-PE-D-bugs
bernarduskrishna Nov 3, 2021
de310fa
Merge branch 'master' of github.com:GraceWang2322/tp
Nov 3, 2021
75cf22c
Fix sale price not showing properly in card
bernarduskrishna Nov 3, 2021
971c9a0
Fix discrepancy between sampleBookKeeping and sampleInventory
bernarduskrishna Nov 3, 2021
21d849c
Clear should clear not only inventory but also bookkeeping and
bernarduskrishna Nov 3, 2021
d4085fd
Fix error message for edit
bernarduskrishna Nov 3, 2021
267d968
Fix test
bernarduskrishna Nov 3, 2021
7d2c083
Add some javadocs
bernarduskrishna Nov 3, 2021
56e6e42
Fix bugs
Nov 3, 2021
90d7334
Merge pull request #172 from bernarduskrishna/fix-bugs-ped
GraceWang2322 Nov 3, 2021
2429ce5
fix checkstyle
Nov 3, 2021
1c1e25a
Merge pull request #173 from GraceWang2322/Fix-AddToOrder-bugs
bernarduskrishna Nov 3, 2021
06bc913
Merge branch 'master' of github.com:GraceWang2322/tp
Nov 3, 2021
b38dbf9
HelpCommand notify user of invalid commands
Nov 3, 2021
baf85ea
Add HelpCommand tests
Nov 3, 2021
dd30a81
Delete Find and sort in DG
Nov 3, 2021
60503bf
Fix bugs
Nov 3, 2021
a0f4529
Merge pull request #174 from GraceWang2322/Fix-HelpCommand-bugs
bernarduskrishna Nov 3, 2021
dc9e16e
Merge branch 'master' of github.com:GraceWang2322/tp
Nov 3, 2021
7eddebc
Draw class diagram of Model component
Nov 3, 2021
f553370
Update low level class diagram of Model
Nov 3, 2021
c621bc6
Update UG about new class diagrams
Nov 3, 2021
607633c
Fix styles
Nov 3, 2021
3fc7586
Revert "Fix styles"
Nov 3, 2021
5756108
Fix styles
Nov 3, 2021
3a77168
Fix styles
Nov 3, 2021
b4daf75
Merge branch 'master' into add-new-class-diagrams
wangpalex Nov 3, 2021
a6c6550
Merge pull request #177 from wangpeialex/add-new-class-diagrams
wangpalex Nov 3, 2021
76a34f0
Merge branch 'master' of https://github.com/AY2122S1-CS2103-F10-2/tp
Nov 3, 2021
3f9ce31
Add DisplayList implementation details
bryanwee023 Nov 4, 2021
b1d9c04
Include UserPrefs in Model class diagram
Nov 4, 2021
2df9056
Update low level class diagram
Nov 4, 2021
fac9749
Update DG on change of diagrams
Nov 4, 2021
aeaea6a
Merge branch 'master' into add-new-class-diagrams
Nov 4, 2021
4738879
Merge pull request #178 from wangpeialex/add-new-class-diagrams
wangpalex Nov 4, 2021
b1faae4
Fix indexing
bryanwee023 Nov 4, 2021
87dd34e
Edit DisplayList details
bryanwee023 Nov 4, 2021
e7ae1d3
Change theme back to remote
bryanwee023 Nov 4, 2021
aa9a361
Fix naming of image
bryanwee023 Nov 4, 2021
f7acb56
Fix bugs
Nov 4, 2021
53482bb
Update use cases
Nov 4, 2021
715b85d
Merge branch 'master' into Update-DG
GraceWang2322 Nov 4, 2021
a0a3084
Merge pull request #179 from bryanwee023/update-developer-guide
bernarduskrishna Nov 4, 2021
1f43f23
Merge pull request #180 from GraceWang2322/Fix-RemoveCommand-bugs
bernarduskrishna Nov 4, 2021
d9f9ae9
Merge pull request #181 from GraceWang2322/Update-DG
bernarduskrishna Nov 4, 2021
66b3725
Add diagrams for Observer pattern and Model, Ui interaction
Nov 4, 2021
a07b0df
Format use cases
bryanwee023 Nov 4, 2021
fa32b26
Update DG Mutating Inventory
bernarduskrishna Nov 4, 2021
4e37398
Merge branch 'master' into update-developer-guide
bryanwee023 Nov 4, 2021
ed8bb35
Add PPP
Nov 4, 2021
ab67396
Fix styles
Nov 4, 2021
15b74ff
Fix style
wangpalex Nov 4, 2021
a386d33
Merge pull request #184 from wangpeialex/add-new-class-diagrams
wangpalex Nov 4, 2021
5a431a9
Fix style
Nov 4, 2021
6fbdc27
Merge branch 'master' into add-new-class-diagrams
Nov 4, 2021
10b6d8b
Fix newfound bugs.
bernarduskrishna Nov 4, 2021
88d7b7c
Edit architecture section
bryanwee023 Nov 4, 2021
f892f87
Merge branch 'master' into dg-and-bug
bernarduskrishna Nov 4, 2021
8ba1c01
Merge pull request #185 from bernarduskrishna/dg-and-bug
bryanwee023 Nov 4, 2021
32ce776
Merge pull request #183 from bryanwee023/update-developer-guide
bernarduskrishna Nov 4, 2021
eb25dae
Merge branch 'master' of github.com:GraceWang2322/tp
Nov 5, 2021
d560f37
Proofread
Nov 5, 2021
3381b7c
Merge pull request #186 from GraceWang2322/DG-mutating-order-proofread
bernarduskrishna Nov 5, 2021
f129e91
Add missing javadocs descriptions
bryanwee023 Nov 5, 2021
1129525
Merge branch 'master' into add-new-class-diagrams
Nov 5, 2021
33dc09a
Update class diagram of Storage
Nov 5, 2021
abaa649
Merge pull request #187 from wangpeialex/add-new-class-diagrams
wangpalex Nov 5, 2021
a5f3ef4
Rename PPP
Nov 5, 2021
202f388
Edit architectural bugs
bryanwee023 Nov 5, 2021
f5d7ae8
Update tests of StartOrderCommand
Nov 5, 2021
02962d3
Add test data
bryanwee023 Nov 5, 2021
04d2be3
Add test util for paths and typical data
bryanwee023 Nov 5, 2021
0d072a9
Add missing storage tests
bryanwee023 Nov 5, 2021
81a8c24
Fix formatting
bryanwee023 Nov 5, 2021
edc3d19
Update AddToOrderCommandTest
Nov 5, 2021
0a8760c
Add PPP draft
bryanwee023 Nov 5, 2021
e223681
Merge pull request #189 from bryanwee023/add-ppp
bryanwee023 Nov 5, 2021
950b65a
Add tests based PEs
Nov 5, 2021
267a041
Merge pull request #190 from wangpeialex/add-tests-for-logic-component
bryanwee023 Nov 5, 2021
082f574
Enhance tokenizer behaviour
bryanwee023 Nov 5, 2021
8df90e5
Clean up code
bryanwee023 Nov 5, 2021
3e571cc
Fix bugs in test inputs
bryanwee023 Nov 5, 2021
3413a38
Move equivalence partition tests to ParserUtil
bryanwee023 Nov 5, 2021
90c03ab
Remove redundant checking of name prefix
bryanwee023 Nov 5, 2021
3b7b05e
Fix styling
bryanwee023 Nov 5, 2021
581e890
Added range to count constraints message
bryanwee023 Nov 5, 2021
73044de
Add PPP draft
bernarduskrishna Nov 5, 2021
fcf32d8
Merge pull request #193 from bernarduskrishna/master
bernarduskrishna Nov 5, 2021
9ceaf0a
Merge pull request #192 from bryanwee023/enhance-arg-multimap
bernarduskrishna Nov 6, 2021
2c08136
Merge pull request #188 from bryanwee023/add-storage-tests
bernarduskrishna Nov 6, 2021
55ae935
Added purple theme
bryanwee023 Nov 6, 2021
3573880
Resize id label
bryanwee023 Nov 6, 2021
6ccf028
Clean up print statement
bryanwee023 Nov 6, 2021
cd5aa43
Update screenshots
bryanwee023 Nov 6, 2021
cebc00a
Change tag color
bryanwee023 Nov 6, 2021
227287f
fix toString bug
bryanwee023 Nov 6, 2021
1382a09
Bookkeeping and Transactions for testing
Nov 6, 2021
a0b6fe6
Update equals method
Nov 6, 2021
25e659a
Update id generating
Nov 6, 2021
5d52dd3
Update tests
Nov 6, 2021
1d2e483
Merge branch 'master' into Transaction-and-Bookeeping-tests
GraceWang2322 Nov 6, 2021
79cae85
Fix UG inconsistency
Nov 6, 2021
f47a047
Do acceptance testing and fix errors in UG
Nov 6, 2021
1fe39a8
Fix tests
Nov 6, 2021
f3b933b
Fix checkstyle
Nov 6, 2021
f09d8d2
Fix checkstyle
Nov 6, 2021
d462723
Fix tests
Nov 6, 2021
efbaf7c
fix checkstyle
Nov 6, 2021
dd73f29
Merge pull request #196 from GraceWang2322/Transaction-and-Bookeeping…
bernarduskrishna Nov 6, 2021
4deec40
Merge pull request #195 from bryanwee023/rebrand-aesthetics
bernarduskrishna Nov 6, 2021
903b703
Merge pull request #200 from wangpeialex/add-tests-for-logic-component
bernarduskrishna Nov 6, 2021
f91a5de
Jack up model testing
bernarduskrishna Nov 6, 2021
df41966
Fix checkstyle
bernarduskrishna Nov 6, 2021
400b460
Fix checkstyle
bernarduskrishna Nov 6, 2021
8212590
Merge pull request #201 from bernarduskrishna/testing-model
bryanwee023 Nov 6, 2021
fc85039
Set limits to count and price
bryanwee023 Nov 6, 2021
e72e3d7
Add overflow checks to bookkeeping
bryanwee023 Nov 6, 2021
6116112
Update tests
bryanwee023 Nov 6, 2021
646213f
Fix compilation bugs
bryanwee023 Nov 6, 2021
4deaced
Fix PPP formatting
bryanwee023 Nov 6, 2021
cb35547
Add bookkeeping unit test
bryanwee023 Nov 6, 2021
ece4768
Add bookkeeping test
bryanwee023 Nov 6, 2021
08de2f0
Update user guide
bryanwee023 Nov 6, 2021
abc9532
Merge pull request #202 from bryanwee023/fix-bookkeeping-overflow
GraceWang2322 Nov 7, 2021
2f657f7
Proofread user guide
Nov 7, 2021
7d36b40
Fix tests
Nov 7, 2021
9c33624
Fix tests
Nov 7, 2021
23333aa
no message
Nov 7, 2021
986d963
Merge pull request #203 from GraceWang2322/Check-userguide
bernarduskrishna Nov 7, 2021
4041f57
Add Tests for Logic class
bernarduskrishna Nov 7, 2021
8521ff4
Fix Checkstyle
bernarduskrishna Nov 7, 2021
00d9933
Fix Checkstyle
bernarduskrishna Nov 7, 2021
7b6a8c1
Merge pull request #204 from bernarduskrishna/master
bernarduskrishna Nov 7, 2021
6d58013
Update PPP
Nov 7, 2021
c0a79d1
Merge branch 'master' into Update-PPP
Nov 7, 2021
cd28dd3
Merge pull request #205 from GraceWang2322/Update-PPP
GraceWang2322 Nov 7, 2021
0475966
Add test for Command package
bernarduskrishna Nov 7, 2021
401b843
Fix checkstyle
bernarduskrishna Nov 7, 2021
f41f514
Delete extraneous inventory.json
bernarduskrishna Nov 7, 2021
b5b3db5
Merge pull request #206 from bernarduskrishna/testing-logic-commands
bernarduskrishna Nov 7, 2021
e35b694
DG instructions for manual testing
Nov 7, 2021
a2d586d
Fix checkstyle
Nov 7, 2021
accd843
Update Dg format
Nov 7, 2021
15b8352
Merge pull request #207 from GraceWang2322/DG-appendix
bernarduskrishna Nov 7, 2021
750ebc3
Update PPP
Nov 7, 2021
818f8fa
Fix spelling
Nov 7, 2021
adf201a
Merge pull request #208 from GraceWang2322/Change-PPP
bernarduskrishna Nov 7, 2021
234333b
Update DeveloperGuide.md
bernarduskrishna Nov 7, 2021
6500094
Update wang pei PPP
Nov 7, 2021
59993ae
Merge pull request #210 from wangpeialex/update-PPP
wangpalex Nov 7, 2021
1fbb97b
Merge pull request #209 from bernarduskrishna/master
bryanwee023 Nov 7, 2021
66c0edd
Add proposed autocomplete feature
bryanwee023 Nov 7, 2021
f91f060
Fix diagram bugs
bryanwee023 Nov 7, 2021
3b7d085
Add inheritance relation
bryanwee023 Nov 7, 2021
5d15016
Update PPP
bryanwee023 Nov 7, 2021
0343413
Fix formatting
bryanwee023 Nov 7, 2021
6c3573e
Add appendix effort
Nov 7, 2021
e57166c
Update PPP
Nov 7, 2021
5667058
Fix length
Nov 7, 2021
f96dc84
Merge pull request #213 from GraceWang2322/Fix-PPP
bernarduskrishna Nov 7, 2021
1ce9052
Merge pull request #211 from bryanwee023/update-developer-guide
bernarduskrishna Nov 7, 2021
be67399
Merge pull request #212 from wangpeialex/draft-effot
bernarduskrishna Nov 7, 2021
8f133db
Update bernarduskrishna.md
bernarduskrishna Nov 7, 2021
a81753a
Update bernarduskrishna.md
bernarduskrishna Nov 7, 2021
4f7b4a7
Update bernarduskrishna.md
bernarduskrishna Nov 7, 2021
1c0592a
Update AboutUs.md
bernarduskrishna Nov 7, 2021
0e13d95
Update bernarduskrishna.md
bernarduskrishna Nov 7, 2021
dd1e966
Merge pull request #214 from bernarduskrishna/add-ppp
bernarduskrishna Nov 7, 2021
5f98ef4
Update UserGuide.md
bernarduskrishna Nov 7, 2021
eb5b4f8
Update UserGuide.md
bernarduskrishna Nov 7, 2021
b8c52c6
Update UserGuide.md
bernarduskrishna Nov 7, 2021
3f71351
Update UserGuide.md
bernarduskrishna Nov 7, 2021
9dc38d4
Update ForUsers.md
bernarduskrishna Nov 7, 2021
455a108
Update ForUsers.md
bernarduskrishna Nov 7, 2021
dcecf80
Merge pull request #215 from bernarduskrishna/add-ppp
bernarduskrishna Nov 7, 2021
6be2b1c
Merge branch 'AY2122S1-CS2103-F10-2:master' into master
bernarduskrishna Nov 7, 2021
663ba08
Delete AB3 tutorial
bernarduskrishna Nov 7, 2021
a6981c9
Merge pull request #216 from bernarduskrishna/master
bernarduskrishna Nov 7, 2021
312cac5
Update Tutorials.md
bernarduskrishna Nov 7, 2021
8081b0a
Update SettingUp.md
bernarduskrishna Nov 7, 2021
ddae0da
Update DeveloperGuide.md
bernarduskrishna Nov 7, 2021
fcc0136
Merge pull request #217 from bernarduskrishna/master
bernarduskrishna Nov 7, 2021
ba659d6
Merge pull request #218 from bernarduskrishna/final-dg-check
bernarduskrishna Nov 7, 2021
ec2a3ec
Update UserGuide.md
bernarduskrishna Nov 7, 2021
d39991d
Update bernarduskrishna.md
bernarduskrishna Nov 7, 2021
70b6197
Merge pull request #219 from bernarduskrishna/master
bernarduskrishna Nov 7, 2021
5eae063
Revise PPP of wang pei
Nov 8, 2021
d0adf05
Merge pull request #220 from wangpeialex/update-PPP
wangpalex Nov 8, 2021
26ddf26
Fix DG bug
bernarduskrishna Nov 8, 2021
cd0d995
Merge branch 'master' of https://github.com/bernarduskrishna/tp
bernarduskrishna Nov 8, 2021
0e64cfd
Rename PPP filename
bryanwee023 Nov 8, 2021
6fbc8b3
Merge pull request #221 from bernarduskrishna/master
bernarduskrishna Nov 8, 2021
9f0f384
Fix minor DG Bug
bernarduskrishna Nov 8, 2021
0d1786e
Merge pull request #222 from bernarduskrishna/master
bernarduskrishna Nov 8, 2021
41c1132
Fix minor DG bug_3
bernarduskrishna Nov 8, 2021
0fa7b7d
Merge pull request #223 from bernarduskrishna/master
bernarduskrishna Nov 8, 2021
f659a87
Fix minor bugs
bryanwee023 Nov 8, 2021
0d4e522
Fix type warning
bernarduskrishna Nov 8, 2021
68596a0
Merge pull request #224 from bernarduskrishna/master
bernarduskrishna Nov 8, 2021
32d58d7
Fix string formatting bug
bryanwee023 Nov 8, 2021
32887df
Fix transaction details bug
bryanwee023 Nov 8, 2021
cbabf0a
Update tests
bryanwee023 Nov 8, 2021
12e7d47
Add FAQ about omitting transaction details
bryanwee023 Nov 8, 2021
f25189e
Merge branch 'master' into update-developer-guide
bryanwee023 Nov 8, 2021
98f80d1
Change log file name
bernarduskrishna Nov 8, 2021
897d300
Add EOF
bryanwee023 Nov 8, 2021
155b8da
Merge pull request #225 from bryanwee023/update-developer-guide
bernarduskrishna Nov 8, 2021
5bf1066
Merge pull request #226 from bernarduskrishna/master
bernarduskrishna Nov 8, 2021
d5550c9
DG
Nov 8, 2021
d63ccc4
DG
Nov 8, 2021
c03b1c1
Merge pull request #227 from GraceWang2322/Proofread-documents
GraceWang2322 Nov 8, 2021
7a00d95
Fix UG, delete command, list txns, and success message bugs
bernarduskrishna Nov 8, 2021
a6bdd4b
Checkstyle
bernarduskrishna Nov 8, 2021
987bb00
Fix userguide
bernarduskrishna Nov 8, 2021
380341c
Merge pull request #228 from bernarduskrishna/master
bernarduskrishna Nov 8, 2021
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
17 changes: 9 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,14 @@

![Ui](docs/images/Ui.png)

* This is **a sample project for Software Engineering (SE) students**.<br>
# Bogo Bogo
* This is an efficient CLI-based inventory management system that helps small business owners/entrepreneurs keep track it their inventory.<br>
Example usages:
* as a starting point of a course project (as opposed to writing everything from scratch)
* as a case study
* The project simulates an ongoing software project for a desktop application (called _AddressBook_) used for managing contact details.
* It is **written in OOP fashion**. It provides a **reasonably well-written** code base **bigger** (around 6 KLoC) than what students usually write in beginner-level SE modules, without being overwhelmingly big.
* as an inventory tracker
* as a order checker
* This project is based on the AddressBook-Level3 project created by the [SE-EDU initiative](https://se-education.org).
* It is **written in OOP fashion**. It provides a **reasonably well-written** code base **bigger** (around 6 KLoC).
* It comes with a **reasonable level of user and developer documentation**.
* It is named `AddressBook Level 3` (`AB3` for short) because it was initially created as a part of a series of `AddressBook` projects (`Level 1`, `Level 2`, `Level 3` ...).
* For the detailed documentation of this project, see the **[Address Book Product Website](https://se-education.org/addressbook-level3)**.
* This project is a **part of the se-education.org** initiative. If you would like to contribute code to this project, see [se-education.org](https://se-education.org#https://se-education.org/#contributing) for more info.
* It is named `Bogobogo` because it provides fast and efficient managing of inventory just like how bogosort is.
* For the detailed documentation of this project, see the **[BogoBogo Product Website](https://AY2122S1-CS2103-F10-2.github.io/tp)**.
* If you would like to contribute code to this project, see [se-education.org](https://se-education.org#https://se-education.org/#contributing) for more info.
6 changes: 5 additions & 1 deletion build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,11 @@ dependencies {
}

shadowJar {
archiveName = 'addressbook.jar'
archiveName = 'bogobogo.jar'
}

run {
enableAssertions = true
}

defaultTasks 'clean', 'test'
46 changes: 17 additions & 29 deletions docs/AboutUs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
layout: page
title: About Us
parent: The Team
---

We are a team based in the [School of Computing, National University of Singapore](http://www.comp.nus.edu.sg).
Expand All @@ -9,51 +10,38 @@ You can reach us at the email `seer[at]comp.nus.edu.sg`

## Project team

### John Doe
### Bryan Wee Shun Yi

<img src="images/johndoe.png" width="200px">
<img src="images/bryanwee023.png" width="200px">

[[homepage](http://www.comp.nus.edu.sg/~damithch)]
[[github](https://github.com/johndoe)]
[[portfolio](team/johndoe.md)]

* Role: Project Advisor

### Jane Doe

<img src="images/johndoe.png" width="200px">

[[github](http://github.com/johndoe)]
[[portfolio](team/johndoe.md)]
[[github](http://github.com/bryanwee023)]

* Role: Team Lead
* Responsibilities: UI
* Responsibilities: UI, Scheduling and Tracking, Git Expert

### Johnny Doe
### Hay Man Hnin Lwin

<img src="images/johndoe.png" width="200px">
<img src="images/gracewang2322.png" width="200px">

[[github](http://github.com/johndoe)] [[portfolio](team/johndoe.md)]
[[github](http://github.com/gracewang2322)]

* Role: Developer
* Responsibilities: Data
* Responsibilities: Documentation, Deliverables and Deadlines

### Jean Doe
### Wang Pei

<img src="images/johndoe.png" width="200px">
<img src="images/wangpeialex.png" width="200px">

[[github](http://github.com/johndoe)]
[[portfolio](team/johndoe.md)]
[[github](http://github.com/wangpeialex)]

* Role: Developer
* Responsibilities: Dev Ops + Threading
* Responsibilities: Testing, Storage

### James Doe
### Bernardus Krishna

<img src="images/johndoe.png" width="200px">
<img src="images/bernarduskrishna.png" width="200px">

[[github](http://github.com/johndoe)]
[[portfolio](team/johndoe.md)]
[[github](https://github.com/bernarduskrishna)]

* Role: Developer
* Responsibilities: UI
* Responsibilities: Model, Logic
2 changes: 2 additions & 0 deletions docs/Configuration.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
layout: page
title: Configuration guide
parent: For Developers
nav_order: 2
---

Certain properties of the application can be controlled (e.g user preferences file location, logging level) through the configuration file (default: `config.json`).
54 changes: 33 additions & 21 deletions docs/DevOps.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,23 @@
---
layout: page
title: DevOps guide
layout: page title: DevOps guide parent: For Developers
---

* Table of Contents
{:toc}
* Table of Contents {:toc}

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

## Build automation

This project uses Gradle for **build automation and dependency management**. **You are recommended to read [this Gradle Tutorial from the se-edu/guides](https://se-education.org/guides/tutorials/gradle.html)**.

This project uses Gradle for **build automation and dependency management**. **You are recommended to
read [this Gradle Tutorial from the se-edu/guides](https://se-education.org/guides/tutorials/gradle.html)**.

Given below are how to use Gradle for some important project tasks.


* **`clean`**: Deletes the files created during the previous build tasks (e.g. files in the `build` folder).<br>
e.g. `./gradlew clean`

* **`shadowJar`**: Uses the ShadowJar plugin to creat a fat JAR file in the `build/lib` folder, *if the current file is outdated*.<br>
* **`shadowJar`**: Uses the ShadowJar plugin to creat a fat JAR file in the `build/lib` folder, *if the current file is
outdated*.<br>
e.g. `./gradlew shadowJar`.

* **`run`**: Builds and runs the application.<br>
Expand All @@ -29,41 +27,52 @@ Given below are how to use Gradle for some important project tasks.
**`checkstyleTest`**: Runs the code style check for the test code base.

* **`test`**: Runs all tests.<
* `./gradlew test` — Runs all tests
* `./gradlew clean test` — Cleans the project and runs tests
* `./gradlew test`Runs all tests
* `./gradlew clean test`Cleans the project and runs tests

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

## Continuous integration (CI)

This project uses GitHub Actions for CI. The project comes with the necessary GitHub Actions configurations files (in the `.github/workflows` folder). No further setting up required.
This project uses GitHub Actions for CI. The project comes with the necessary GitHub Actions configurations files (in
the `.github/workflows` folder). No further setting up required.

### Code coverage

As part of CI, this project uses Codecov to generate coverage reports. Here are the steps to set up CodeCov for a fork of this repository.
As part of CI, this project uses Codecov to generate coverage reports. Here are the steps to set up CodeCov for a fork
of this repository.

1. Sign up with Codecov using your GitHub account [here](https://codecov.io/signup).
1. Once you are inside Codecov web app, add your fork to CodeCov.
1. Get the Markdown code for the Codecov badge provided in `Settings > Badges` and update the `docs/index.md` of your repo with it so that the badge [![codecov](https://codecov.io/gh/se-edu/addressbook-level3/branch/master/graph/badge.svg)](https://codecov.io/gh/se-edu/addressbook-level3) in that page reflects the coverage of your project.
1. Get the Markdown code for the Codecov badge provided in `Settings > Badges` and update the `docs/index.md` of your
repo with it so that the
badge [![codecov](https://codecov.io/gh/se-edu/addressbook-level3/branch/master/graph/badge.svg)](https://codecov.io/gh/se-edu/addressbook-level3)
in that page reflects the coverage of your project.

### Repository-wide checks

In addition to running Gradle checks, CI includes some repository-wide checks. Unlike the Gradle checks which only cover files used in the build process, these repository-wide checks cover all files in the repository. They check for repository rules which are hard to enforce on development machines such as line ending requirements.
In addition to running Gradle checks, CI includes some repository-wide checks. Unlike the Gradle checks which only cover
files used in the build process, these repository-wide checks cover all files in the repository. They check for
repository rules which are hard to enforce on development machines such as line ending requirements.

These checks are implemented as POSIX shell scripts, and thus can only be run on POSIX-compliant operating systems such as macOS and Linux. To run all checks locally on these operating systems, execute the following in the repository root directory:
These checks are implemented as POSIX shell scripts, and thus can only be run on POSIX-compliant operating systems such
as macOS and Linux. To run all checks locally on these operating systems, execute the following in the repository root
directory:

`./config/travis/run-checks.sh`

Any warnings or errors will be printed out to the console.

**If adding new checks:**

* Checks are implemented as executable `check-*` scripts within the `.github` directory. The `run-checks.sh` script will automatically pick up and run files named as such. That is, you can add more such files if you need and the CI will do the rest.
* Checks are implemented as executable `check-*` scripts within the `.github` directory. The `run-checks.sh` script will
automatically pick up and run files named as such. That is, you can add more such files if you need and the CI will do
the rest.

* Check scripts should print out errors in the format `SEVERITY:FILENAME:LINE: MESSAGE`
* SEVERITY is either ERROR or WARN.
* FILENAME is the path to the file relative to the current directory.
* LINE is the line of the file where the error occurred and MESSAGE is the message explaining the error.
* SEVERITY is either ERROR or WARN.
* FILENAME is the path to the file relative to the current directory.
* LINE is the line of the file where the error occurred and MESSAGE is the message explaining the error.

* Check scripts must exit with a non-zero exit code if any errors occur.

Expand All @@ -73,7 +82,10 @@ Any warnings or errors will be printed out to the console.

Here are the steps to create a new release.

1. Update the version number in [`MainApp.java`](https://github.com/se-edu/addressbook-level3/tree/master/src/main/java/seedu/address/MainApp.java).
1. Update the version number
in [`MainApp.java`](https://github.com/se-edu/addressbook-level3/tree/master/src/main/java/seedu/address/MainApp.java)
.
1. Generate a fat JAR file using Gradle (i.e., `gradlew shadowJar`).
1. Tag the repo with the version number. e.g. `v0.1`
1. [Create a new release using GitHub](https://help.github.com/articles/creating-releases/). Upload the JAR file you created.
1. [Create a new release using GitHub](https://help.github.com/articles/creating-releases/). Upload the JAR file you
created.
Loading