Skip to content

Commit 67f7f74

Browse files
gb3hgb3h
andauthored
Add adoc header tags (#263)
* Edit * PR+ * Edit PPP for stephen * Edit PPP for stephen Co-authored-by: gb3h <[email protected]>
1 parent b322af7 commit 67f7f74

File tree

6 files changed

+49
-64
lines changed

6 files changed

+49
-64
lines changed

docs/DeveloperGuide.adoc

Lines changed: 16 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Refer to the guide <<SettingUp#, here>>.
2424
== Design
2525

2626
[[Design-Architecture]]
27-
=== Architecture
27+
=== Architecture [Wong Chi Shan]
2828

2929
.Architecture Diagram
3030
image::developer-guide/common/ArchitectureDiagram.png[]
@@ -69,7 +69,7 @@ image::developer-guide/common/ArchitectureSequenceDiagram.png[]
6969
The sections below give more details of each component.
7070

7171
[[Design-Main]]
72-
=== Main Component
72+
=== Main Component [Aloysius Chan]
7373
.Structure of the Main Component
7474
image::developer-guide/common/MainClassDiagram.png[]
7575

@@ -82,7 +82,7 @@ When the app starts up, `Main#main` is called. This sets the `Preloader` of the
8282
During the GUI start up process, the `SplashScreen` will first load on a `Thread`. In the meantime, `MainApp#init` will run. Once `MainApp#init` completes, and just as `MainApp#start` is about to run, `MainApp` will send a `Preloader.StateChangeNotification` to `SplashScreen` to close its window. After that, `UiManager#start` is called, which creates the view for the main application.
8383

8484
[[Design-Ui]]
85-
=== UI Component
85+
=== UI Component [Aloysius Chan]
8686

8787
.Structure of the UI Component
8888
image::developer-guide/common/UiClassDiagram.png[]
@@ -98,7 +98,7 @@ The `UI` component executes user commands using the `Logic` component.
9898
For more information about each component, check out the 'Implementation' section.
9999

100100
[[Design-Logic]]
101-
=== Logic Component
101+
=== Logic Component [Aloysius Chan]
102102

103103
[[fig-LogicClassDiagram]]
104104
.Structure of the Logic Component
@@ -126,7 +126,7 @@ NOTE: The lifeline for `ExerciseCommandParser` and `DeleteCommandParser` should
126126
For more information about each component, check out the 'Implementation' section.
127127

128128
[[Design-Model]]
129-
=== Model Component
129+
=== Model Component [Aloysius Chan]
130130

131131
.Structure of the Model Component
132132
image::developer-guide/common/ModelClassDiagram.png[]
@@ -148,7 +148,7 @@ The `Model`:
148148
For more information about each component, check out the 'Implementation' section.
149149

150150
[[Design-Storage]]
151-
=== Storage Component
151+
=== Storage Component [Aloysius Chan]
152152

153153
.Structure of the Storage Component
154154
image::developer-guide/common/StorageClassDiagram.png[]
@@ -176,7 +176,7 @@ This section describes some noteworthy details on how each features are implemen
176176

177177
// tag::session[]
178178

179-
=== Session (Home)
179+
=== Session (Home) [Gabriel Yeo]
180180
==== Implementation
181181
The Session feature resides on the Home page and is comprised of `Start`, `Stop`, `Done`, and `Skip` commands.
182182
`OngoingWorkout`, `OngoingSession`, `OngoingSet`, and `OngoingSetList` are models that are vital components of the feature.
@@ -274,9 +274,7 @@ workout session, where all remaining sets are marked as incomplete.
274274
// end::session[]
275275

276276
// tag::exercise[]
277-
=== Exercise
278-
Aloysius Chan
279-
277+
=== Exercise [Aloysius Chan]
280278
==== Overview
281279
The Exercise feature forms the basic building block for the application. It allows users to CRUD exercises, which will then be used for the creation of workouts. The command is prefixed by the keyword `exercise`. Available commands are `create`, `edit`, `list`, `delete` and many more.
282280

@@ -368,7 +366,7 @@ However, for exercises, we noted that users tend to reuse the same exercise thro
368366
// end::exercise[]
369367

370368
// tag::workout[]
371-
=== Workout
369+
=== Workout [Wong Chi Shan]
372370
==== Overview
373371
The workout feature in ZeroToOne allows users to manage their workouts! Users will be able to create a workout, add exercises to it, as well as edit the workout and its exercises, and more.
374372

@@ -467,8 +465,8 @@ other than the context that they are referenced in. In addition, this would make
467465
// end::workout[]
468466

469467
// tag::schedule[]
470-
=== Schedule
471-
Guofeng Tang
468+
=== Schedule [Tang Guofeng]
469+
472470

473471
==== Overview
474472
The schedule feature in ZeroToOne allows users to plan their workouts! Users will be able to create a schedule on a specific date and time in the future, edit the date and time, as well as delete the schedule.
@@ -576,7 +574,7 @@ On the other hand, implementing option 2 makes it easier to handle these problem
576574

577575

578576
// tag::log[]
579-
=== Log Statistics
577+
=== Log Statistics [Liow Jiachen]
580578
The log statistics feature in ZeroToOne allows users to view their completed workouts visually with meaningful aggregated information so they can see how much progress made.
581579

582580
==== Overview
@@ -721,7 +719,7 @@ Refer to the guide <<DevOps#, here>>.
721719
Manage workouts faster than a typical mouse/GUI-driven app
722720

723721
[appendix]
724-
== User Stories
722+
== User Stories [Wong Chi Shan]
725723

726724
Priorities: High (must have) - `* * \*`, Medium (nice to have) - `* \*`, Low (unlikely to have) - `*`
727725

@@ -762,7 +760,7 @@ Priorities: High (must have) - `* * \*`, Medium (nice to have) - `* \*`, Low (un
762760
|=======================================================================
763761

764762
[appendix]
765-
== Use Cases
763+
== Use Cases [Wong Chi Shan]
766764

767765
(For all use cases below, the *System* is the `ZeroToOne` and the *Actor* is the `user`, unless specified otherwise)
768766

@@ -876,7 +874,7 @@ A set of exercises to be done together, in a certain order and time frame.
876874

877875
//tag::gb3h[]
878876
[appendix]
879-
== Instructions for Manual Testing
877+
== Instructions for Manual Testing [Gabriel Yeo]
880878

881879
Given below are instructions to test the app manually.
882880

@@ -925,8 +923,7 @@ These instructions only provide a starting point for testers to work on; testers
925923

926924
//tag::session[]
927925
[appendix]
928-
== Effort
929-
Gabriel Yeo
926+
== Effort [ZeroToOne Team]
930927

931928

932929
[width="59%",cols="22%,<23%,<25%,options="header",]
@@ -960,7 +957,6 @@ Furthermore, on top of the ~16k LoC added to the project, the ZeroToOne team has
960957
The largest challenge we faced as a team was communication.
961958
Being fast-moving and driven individuals, taking the initiative sometimes meant being able to make decisions for the team as an individual. This meant that it was vital that we were on the same page with our goals and expectations from the project.
962959
Thus, we took more time than usual at the beginning of the project to plan our road-map moving forward, delegating work and defining our expectations clearly.
963-
This meant we were later to start coding and making PRs than other teams (as seen on reposense), which we felt was a more-than-fair trade-off for our team dynamic.
964960

965961
We hope you have enjoyed this journey and learnt as much as we have!
966962
- The ZeroToOne Team

docs/UserGuide.adoc

Lines changed: 16 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -74,8 +74,7 @@ image::user-guide/UgMainPage.png[]
7474
At this stage, you should have successfully started ZeroToOne and will be able see the main page as described in Figure 1. If the application did not start, please refer to <<Troubleshooting>> for more information to resolve the issue. Otherwise, the next step is to begin your ZeroToOne journey, by customising your favourite workout programmes!
7575

7676
// tag::ui[]
77-
== User Interface Basics
78-
Chi Shan
77+
== User Interface Basics [Wong Chi Shan]
7978

8079
Before we delve into the commands that you can use, let us first explain the components of the User Interface, and how we can navigate through them.
8180

@@ -99,7 +98,7 @@ You type all of your commands in here. To execute the command, simply press the
9998

10099
At this point, you should have sufficient knowledge to start using ZeroToOne. In this section, we will describe in-depth the features that ZeroToOne has, and how you can interact with them.
101100

102-
=== Overview
101+
=== Overview [Wong Chi Shan]
103102
For ZeroToOne commands, every user-fillable parameter is identified by a flag prefix. This allows ZeroToOne to accept parameters in any order. However, to correctly parse your command, we have reserved these flags as special symbols that are to be used only by the program. Please avoid using them in your commands. The reserved flags are listed as follows:
104103

105104
* `e/` - exercise name
@@ -114,9 +113,7 @@ For ZeroToOne commands, every user-fillable parameter is identified by a flag pr
114113
* `et/` - end datetime
115114

116115
// tag::about[]
117-
=== Viewing App Information
118-
Chi Shan
119-
116+
=== Viewing App Information [Wong Chi Shan]
120117
Can’t remember the commands off the top of your head? Fret not. ZeroToOne provides you with a convenient way to view a list of all available commands that you can try. Simply enter the following command into the command box:
121118

122119
```
@@ -129,7 +126,7 @@ The app view will switch tabs to show the About tab.
129126

130127
// end::about[]
131128

132-
=== Closing ZeroToOne
129+
=== Closing ZeroToOne [Wong Chi Shan]
133130
After you have finished using the application, you can exit the application by simply entering the following command into the command box:
134131

135132
```
@@ -144,8 +141,7 @@ Thank you for using ZeroToOne! Your data has been saved successfully. Hope to se
144141

145142
//tag::session[]
146143

147-
=== Starting A Workout Session
148-
Gabriel Yeo
144+
=== Starting A Workout Session [Gabriel Yeo]
149145

150146
Are you ready to start working out now? To begin a new workout session, simply enter the following command into the command box:
151147

@@ -169,7 +165,7 @@ NOTE:
169165
* WORKOUT_ID cannot be null and should be a value of a workout from the workout tab.
170166
```
171167

172-
=== Completing a Set
168+
=== Completing a Set [Gabriel Yeo]
173169
Completed your exercise set? To mark the current exercise set as complete and move on to the next set, simply enter this command into the command box:
174170

175171
```
@@ -186,7 +182,7 @@ After however many seconds you wish to rest, you may continue on to your next se
186182

187183
If you were already on your last set, ZeroToOne will automatically stop the workout session after this command is executed and save your session to the `Log`.
188184

189-
=== Skipping An Exercise Set
185+
=== Skipping An Exercise Set [Gabriel Yeo]
190186
Unable to complete your current exercise set? No worries, it happens to the best of us. To skip the current exercise set, simply enter this command into the command box:
191187

192188
```
@@ -200,7 +196,7 @@ The background color of the completed set will turn red, indicating that the set
200196

201197
This action is otherwise identical to the `done` command.
202198

203-
=== Stopping A Workout Session
199+
=== Stopping A Workout Session [Gabriel Yeo]
204200
Need to stop the workout session prematurely? Simply enter this command into the command box:
205201

206202
```
@@ -217,9 +213,7 @@ Stopped workout session: Push Day at 13 Apr 2020, 3:36:17 PM
217213
//end::session[]
218214

219215
// tag::exercise[]
220-
=== Managing Your Exercises
221-
Aloysius Chan
222-
216+
=== Managing Your Exercises [Aloysius Chan]
223217
The commands in this section allows you to manage your customised exercises in ZeroToOne. These exercises will eventually be the building blocks of a workout.
224218

225219
==== Creating a new exercise
@@ -400,8 +394,7 @@ Deleted Exercise: Deadlift
400394
// end::exercise[]
401395

402396
// tag::workout[]
403-
=== Managing Your Workouts
404-
Chi Shan
397+
=== Managing Your Workouts [Wong Chi Shan]
405398

406399
After creating and modifying your exercises however you desire, it’s time to use those exercises to create workouts! In this section, we will walk you through how to manage all your workouts.
407400

@@ -626,8 +619,7 @@ Successfully imported /data/myFriendsWorkout.txt as a new workout: My Friend's W
626619
// end::workout[]
627620

628621
// tag::schedule[]
629-
=== Managing Your Scheduled Sessions
630-
Guofeng Tang
622+
=== Managing Your Scheduled Sessions [Tang Guofeng]
631623

632624
You are now an expert in managing your workouts, and can start a workout any time! However, wouldn’t you like to have the ability to schedule your workout sessions? In this section, we will guide you to learn how ZeroToOne can help you in this aspect!
633625

@@ -653,7 +645,7 @@ NOTE:
653645
* <datetime> must not be outdated and follow the format {yyyy}-{mm}-{dd} {HH:mm}
654646
```
655647

656-
==== Listing all scheduled sessions
648+
==== Listing all scheduled sessions [Tang Guofeng]
657649

658650
To view all of your schedule sessions, type the following command:
659651

@@ -743,7 +735,7 @@ NOTE:
743735
// end::schedule[]
744736

745737
// tag::log[]
746-
=== Managing Your Session Logs
738+
=== Managing Your Session Logs [Liow Jiachen]
747739
Well done, you have successfully gone through the whole process of setting up your workouts, scheduling them and even logging the workout. In addition to all these cool features, ZeroToOne also allows you to manage your workout log history and even provides you with meaningful statistics to help you track your current progress to help you hit all those fitness goals.
748740

749741
==== Viewing your logs
@@ -947,7 +939,7 @@ A single type of exercise, for example push ups or crunches.
947939

948940
*Gradle*
949941

950-
A build automation tool...
942+
A build automation tool.
951943

952944
*GUI*
953945

@@ -960,7 +952,7 @@ A specific instantiation of an object.
960952

961953
*Java*
962954

963-
A programming language...
955+
A programming language.
964956

965957
*Mainstream OS*
966958

@@ -983,4 +975,5 @@ An exercise set that consists of the number of repetitions and its weight.
983975
A list of exercises to be done together, in a certain order.
984976

985977
*Log*
978+
986979
A workout that has been completed and stored away safely.

docs/team/Guofeng-Tang.adoc

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,6 @@
55

66
== PROJECT: ZeroToOne
77

8-
.Screenshot
9-
image::user-guide/UgScheduleSession.png[]
10-
118
== Overview
129

1310
ZeroToOne is a desktop application that serves as an all-in-one exercise tracker and personal aide. The user interacts with it using a CLI, and it has a GUI created with JavaFX. It is written in Java, and has about 26 kLoC.
@@ -18,7 +15,7 @@ ZeroToOne is a desktop application that serves as an all-in-one exercise tracker
1815

1916
** What it does: allows the user to schedule workout sessions.
2017

21-
** Justification: this feature is essential to the product as it enbale user to make plans of their workout sessions, stick to the plans and finally achieve a life transformation.
18+
** Justification: this feature is essential to the product as it enable user to make plans of their workout sessions, stick to the plans and finally achieve a life transformation.
2219

2320
** Highlights: this feature affects efficiency and responsiveness if not implemented correctly. It required careful consideration and analysis of design alternatives. The implementation itself was challenging because it required implementation of a fairly complex model as well as its storage.
2421

docs/team/alloystory.adoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,6 @@
55

66
== PROJECT: ZeroToOne
77

8-
.Screenshot
9-
image::user-guide/UgExerciseList.png[]
108

119
== Overview
1210

docs/team/chishanw.adoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,6 @@
55

66
== PROJECT: ZeroToOne
77

8-
.Screenshot
9-
image::user-guide/UgWorkoutList.png[]
108

119
== Overview
1210

docs/team/gb3h.adoc

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -29,20 +29,23 @@ Major design consideration was required to ensure that the timer was not computa
2929

3030
** *Overview*: https://nus-cs2103-ay1920s2.github.io/tp-dashboard/#search=gb3h&sort=groupTitle&sortWithin=title&since=2020-02-14&timeframe=commit&mergegroup=false&groupSelect=groupByRepos&breakdown=false[Reposense]
3131

32-
** *Functional Code*:
32+
|===
33+
|*Feature* |*Component* |*Functional Code* |*Test Code*
34+
35+
.5+|Session feature |Commands (Start, Stop, Skip, Done) |https://github.com/AY1920S2-CS2103T-W16-2/main/tree/master/src/main/java/seedu/zerotoone/logic/commands[github folder] |https://github.com/gb3h/main/tree/master/src/test/java/seedu/zerotoone/logic/commands[github folder]
36+
37+
|Parsers |https://github.com/AY1920S2-CS2103T-W16-2/main/tree/master/src/main/java/seedu/zerotoone/logic/parser/session[github folder] |https://github.com/gb3h/main/tree/master/src/test/java/seedu/zerotoone/logic/parser/session[github folder]
38+
39+
|Models (Ongoing- prefixed) |https://github.com/gb3h/main/tree/master/src/main/java/seedu/zerotoone/model/session[github folder] |https://github.com/gb3h/main/tree/master/src/test/java/seedu/zerotoone/model/session[github folder]
3340

34-
1. https://github.com/AY1920S2-CS2103T-W16-2/main/tree/master/src/main/java/seedu/zerotoone/logic/commands[github folder] <- Commands (Start, Stop, Skip, Done)
35-
2. https://github.com/AY1920S2-CS2103T-W16-2/main/tree/master/src/main/java/seedu/zerotoone/logic/parser/session[github folder] <- Parsers
36-
3. https://github.com/gb3h/main/tree/master/src/main/java/seedu/zerotoone/model/session[github folder] <- Models (All the Ongoing- models and worked in collaboration with @Jiachen247 for some Completed- models)
37-
4. https://github.com/gb3h/main/tree/master/src/main/java/seedu/zerotoone/ui/views/home[github folder] <- UI work
38-
5. https://github.com/gb3h/main/tree/master/src/main/resources/view/home[github folder] <- FXML
39-
6. https://github.com/AY1920S2-CS2103T-W16-2/main/blob/master/src/main/java/seedu/zerotoone/model/ModelManager.java[github file] <- Timer functionality (and major session-related functions)
41+
|Ui |https://github.com/gb3h/main/tree/master/src/main/java/seedu/zerotoone/ui/views/home[github folder] | NA
4042

41-
** *Tests*:
43+
|FXML |https://github.com/gb3h/main/tree/master/src/main/resources/view/home[github folder] |NA
44+
45+
.1+|Timer feature |Found in ModelManager |https://github.com/AY1920S2-CS2103T-W16-2/main/blob/master/src/main/java/seedu/zerotoone/model/ModelManager.java[github file] | NA
46+
47+
|===
4248

43-
1. https://github.com/gb3h/main/tree/master/src/test/java/seedu/zerotoone/logic/commands[github folder] <- Command Tests (Start, Stop, Skip, Done)
44-
2. https://github.com/gb3h/main/tree/master/src/test/java/seedu/zerotoone/logic/parser/session[github folder] <- Parser Tests
45-
3. https://github.com/gb3h/main/tree/master/src/test/java/seedu/zerotoone/model/session[github folder] <- Model Tests
4649

4750
---
4851

@@ -55,14 +58,14 @@ Major design consideration was required to ensure that the timer was not computa
5558
*** Edit GUI for overall cohesiveness (Pull requests https://github.com/AY1920S2-CS2103T-W16-2/main/pull/213[#213], https://github.com/AY1920S2-CS2103T-W16-2/main/pull/219[#219])
5659
*** Disabled non session related commands during a session for more predictable app behaviour (no editing of workouts during workout) (Pull requests https://github.com/AY1920S2-CS2103T-W16-2/main/pull/187[#187])
5760
** Documentation:
58-
*** Add documentation coverage for the entire workout session feature including diagrams. https://github.com/AY1920S2-CS2103T-W16-2/main/pull/110[#14]
61+
*** Add documentation coverage for the entire workout session feature including diagrams. https://github.com/AY1920S2-CS2103T-W16-2/main/pull/110[#110]
5962
*** Edit Model Component diagram. https://github.com/AY1920S2-CS2103T-W16-2/main/pull/238[#238]
6063
*** Update all screenshots in user guide. https://github.com/AY1920S2-CS2103T-W16-2/main/pull/241[#241]
6164
*** Add DG Appendix F and G. https://github.com/AY1920S2-CS2103T-W16-2/main/pull/244[#244], https://github.com/AY1920S2-CS2103T-W16-2/main/pull/254[#254]
6265
** Review Contributions:
6366
*** PRs reviewed (with non-trivial review comments):
6467
https://github.com/AY1920S2-CS2103T-W16-2/main/pull/66[#66], https://github.com/AY1920S2-CS2103T-W16-2/main/pull/114[#114]
65-
*** Total PRs reviewed: https://github.com/AY1920S2-CS2103T-W16-2/main/pulls?q=is%3Apr+is%3Aclosed+reviewed-by%3Agb3h[15]
68+
*** Total PRs reviewed: https://github.com/AY1920S2-CS2103T-W16-2/main/pulls?q=is%3Apr+is%3Aclosed+reviewed-by%3Agb3h[21+]
6669
** Community:
6770
*** Reviewed other teams documentation: https://github.com/nus-cs2103-AY1920S2/addressbook-level3/pull/29[#29]
6871

0 commit comments

Comments
 (0)