Skip to content

Commit

Permalink
Merge pull request #325 from tituschewxj/fix-dg-4
Browse files Browse the repository at this point in the history
docs: Update DG and UG content page
  • Loading branch information
tituschewxj authored Apr 15, 2024
2 parents 1484ee7 + 0102e69 commit 30d57cd
Show file tree
Hide file tree
Showing 4 changed files with 84 additions and 6 deletions.
38 changes: 38 additions & 0 deletions docs/DGContentPage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
## **Table of Contents**

* [**Acknowledgements**](DeveloperGuide.md#acknowledgements)
* [**Setting up, getting started**](DeveloperGuide.md#setting-up-getting-started)
* [**Design**](DeveloperGuide.md#design)
* [Architecture](DeveloperGuide.md#architecture)
* [UI component](DeveloperGuide.md#ui-component)
* [Logic component](DeveloperGuide.md#logic-component)
* [Model component](DeveloperGuide.md#model-component)
* [Storage component](DeveloperGuide.md#storage-component)
* [Common classes](DeveloperGuide.md#common-classes)
* [**Implementation**](DeveloperGuide.md#implementation)
* [Autocomplete Feature](DeveloperGuide.md#autocomplete-feature)
* [Command History Retrieval](DeveloperGuide.md#command-history-retrieval)
* [[Proposed] Undo/Redo Feature](DeveloperGuide.md#proposed-undo-redo-feature)
* [**Documentation, logging, testing, configuration, dev-ops**](DeveloperGuide.md#documentation-logging-testing-configuration-dev-ops)
* [**Appendix: Requirements**](DeveloperGuide.md#appendix-requirements)
* [Product scope](DeveloperGuide.md#product-scope)
* [User stories](DeveloperGuide.md#user-stories)
* [Use cases](DeveloperGuide.md#use-cases)
* [Non-Functional Requirements](DeveloperGuide.md#non-functional-requirements)
* [Glossary](DeveloperGuide.md#glossary)
* [**Appendix: Instructions for manual testing**](DeveloperGuide.md#appendix-instructions-for-manual-testing)
* [Launch and shutdown](DeveloperGuide.md#launch-and-shutdown)
* [Adding a student](DeveloperGuide.md#adding-a-student)
* [Editing a student](DeveloperGuide.md#editing-a-student)
* [Deleting a student](DeveloperGuide.md#deleting-a-student)
* [Finding a student](DeveloperGuide.md#finding-a-student)
* [Marking a student's attendance](DeveloperGuide.md#marking-a-student-s-attendance)
* [Unmarking a student's attendance](DeveloperGuide.md#unmarking-a-student-s-attendance)
* [Setting the course name](DeveloperGuide.md#setting-the-course-name)
* [Autocompleting fields](DeveloperGuide.md#autocompleting-fields)
* [Retrieving previous successful commands](DeveloperGuide.md#retrieving-previous-successful-commands)
* [Accessing help](DeveloperGuide.md#accessing-help)
* [Clearing all data](DeveloperGuide.md#clearing-all-data)
* [**Appendix: Design Decisions**](DeveloperGuide.md#appendix-design-decisions)
* [**Appendix: Effort**](DeveloperGuide.md#appendix-effort)
* [**Appendix: Planned Enhancements**](DeveloperGuide.md#appendix-planned-enhancements)
11 changes: 7 additions & 4 deletions docs/DeveloperGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,10 @@
# TAPro Developer Guide

<!-- * Table of Contents -->
<page-nav-print>Table of Contents</page-nav-print>
<div class="d-none d-print-block">
<br>
<include src="DGContentPage.md" />
</div>

{{ newPage }}

Expand Down Expand Up @@ -81,7 +84,7 @@ The bulk of TAPro's work is done by the following four components:
The *Sequence Diagram* below shows how the components interact with each other for the scenario where the user
issues the command `delstu nn/E1234567`.

<puml src="diagrams/ArchitectureSequenceDiagram.puml" width="574" />
<puml src="diagrams/ArchitectureSequenceDiagram.puml" width="680" />

Each of the four main components (also shown in the diagram above),

Expand All @@ -96,7 +99,7 @@ The `Logic` component defines its API in the `Logic.java` interface and implemen

Other components interact with a given component through its interface rather than the concrete class, as illustrated in the (partial) class diagram below.

<puml src="diagrams/ComponentManagers.puml" width="300" />
<puml src="diagrams/ComponentManagers.puml" width="290" />

<box type="tip" light>

Expand Down Expand Up @@ -496,7 +499,7 @@ The following activity diagram summarizes what happens when a user executes a ne

{{ newPageBetween }}

#### Design considerations:
#### Design considerations

**Aspect: How undo & redo executes:**

Expand Down
36 changes: 36 additions & 0 deletions docs/UGContentPage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
## <i class="fa-solid fa-rectangle-list"></i> **Table of Contents**

* [**Navigating this User Guide**](UserGuide.md#navigating-this-user-guide)
* [**Useful Notations and Glossary**](UserGuide.md#useful-notations-and-glossary)
* [Symbols](UserGuide.md#symbols)
* [Keywords](UserGuide.md#keywords)
* [Abbreviations](UserGuide.md#abbreviations)
* [Command Format](UserGuide.md#command-format)
* [Parameters and their Recognized Prefixes](UserGuide.md#parameters-and-their-recognized-prefixes)
* [Other Parameters](UserGuide.md#other-parameters)
* [**Navigating the GUI**](UserGuide.md#navigating-the-gui)
* [**Quick start**](UserGuide.md#quick-start)
* [**Features**](UserGuide.md#features)
* [Viewing help: `help`](UserGuide.md#viewing-help-help)
* [Name/Rename CS course: `setcrs`](UserGuide.md#name-rename-cs-course-setcrs)
* [Adding a student: `addstu`](UserGuide.md#adding-a-student-addstu)
* [Listing all students: `list`](UserGuide.md#listing-all-students-list)
* [Editing a student: `edit`](UserGuide.md#editing-a-student-edit)
* [Locating students by name: `find`](UserGuide.md#locating-students-by-name-find)
* [Marking a student's attendance for a given week by their NUSNet ID: `mark`](UserGuide.md#marking-a-student-s-attendance-for-a-given-week-by-their-nusnet-id-mark)
* [Unmarking a student's attendance for a given week by their NUSNet ID: `unmark`](UserGuide.md#unmarking-a-student-s-attendance-for-a-given-week-by-their-nusnet-id-unmark)
* [Deleting a student: `delstu`](UserGuide.md#deleting-a-student-delstu)
* [Clearing all entries: `clear`](UserGuide.md#clearing-all-entries-clear)
* [Exiting the program: `exit`](UserGuide.md#exiting-the-program-exit)
* [Autocomplete](UserGuide.md#autocomplete)
* [Retrieving command history](UserGuide.md#retrieving-command-history)
* [Saving the data](UserGuide.md#saving-the-data)
* [Editing the data file](UserGuide.md#editing-the-data-file)
* [**Command summary**](UserGuide.md#command-summary)
* [**Known issues**](UserGuide.md#known-issues)
* [**FAQ**](UserGuide.md#faq)
* [Transfering Data to Another Computer](UserGuide.md#transfering-data-to-another-computer)
* [Loading Data from Another Computer](UserGuide.md#loading-data-from-another-computer)
* [Launching TAPro](UserGuide.md#launching-tapro)
* [Checking Java Version](UserGuide.md#checking-java-version)
* [Saving More Time](UserGuide.md#saving-more-time)
5 changes: 3 additions & 2 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,9 @@ If you can type fast, TAPro can get your contact management and attendance takin
{{ newPageBetween }}

<!-- * Table of Contents -->
<page-nav-print />

<div class="d-none d-print-block">
<include src="UGContentPage.md" />
</div>
{{ newPage }}

## <i class="fa-solid fa-forward"></i> Navigating this User Guide
Expand Down

0 comments on commit 30d57cd

Please sign in to comment.