refactor: restructure documentation (#283)

Author: mschoettle

_typos.toml renamed to .typos.toml

@@ -17,7 +17,7 @@ Sequence diagrams can be used to convey message exchanges at different levels of
 
 <figure markdown>
   ![Import elements of a sequence diagram](images/sequence_diagram_elements.png)
-  <figcaption>A sample sequence diagram with some import elements (<a href="https://mattsch.com/research/publications/#paper-7">Source</a>)</figcaption>
+  <figcaption>A sample sequence diagram with some import elements (<a href="https://mattsch.com/research/#paper-1">Source</a>)</figcaption>
 </figure>
 
 A detailed overview of all the elements can be found on [uml-diagrams.org](https://www.uml-diagrams.org/sequence-diagrams.html).

docs/development/guides/sequence_diagrams.md

@@ -31,8 +31,8 @@ The following is a high-level overview of each section:
 1. [User Guide](user/index.md) (coming soon): instructions on navigating and configuring the Opal system as an end-user or administrator.
 1. [Contribute](development/index.md): everything you need to know as a developer to contribute to Opal's open-source development:
     - [Architecture](development/architecture/index.md)
-    - [Setting up a local development environment](development/setup.md)
-1. [Deploy](deploy/index.md) (coming soon): how to deploy the Opal system in an environment
+    - [Setting up a local development environment](development/local-dev-setup.md)
+1. [Install](install/index.md) (coming soon): how to deploy the Opal system in an environment
 
 ## Try it Yourself
 

docs/development/setup.md renamed to docs/development/local-dev-setup.md

@@ -13,7 +13,7 @@ The user applications are deployed and maintained by the Opal Health Informatics
 
 ### Deployment diagram
 
-```plantuml source="docs/deploy/diagrams/deployment_diagram_pie.puml"
+```plantuml source="docs/install/diagrams/deployment_diagram_pie.puml"
 ```
 
 Relationships between components on the same host are left out for brevity (except those making use of third-party components).
@@ -22,5 +22,5 @@ Relationships between components on the same host are left out for brevity (exce
 
 ### Deployment diagram
 
-```plantuml source="docs/deploy/diagrams/deployment_diagram_user.puml"
+```plantuml source="docs/install/diagrams/deployment_diagram_user.puml"
 ```

docs/index.md

@@ -29,7 +29,7 @@ nav:
       - development/architecture/migration.md
       - Registration Process: development/architecture/registration.md
       - development/architecture/checkin_process.md
-    - development/setup.md
+    - Set up a Local Development Environment: development/local-dev-setup.md
     - Best Practices:
       - Overview: development/best_practices/best_practices.md
       - Code Review: development/best_practices/code_review.md
@@ -41,9 +41,9 @@ nav:
           - JavaScript: development/guides/javascript.md
       - Sequence Diagrams: development/guides/sequence_diagrams.md
       - Generate Self Signed Certificates: development/guides/self_signed_certificates.md
-  - Deploy:
-    - Deploying The Opal Solution: deploy/index.md
-    - Hospital Integration: deploy/integration.md
+  - Install:
+    - Deploying the Opal Solution: install/index.md
+    - Hospital Integration: install/integration.md
 
 # Configuration
 theme: