Merge PR #7 from TaskarCenterAtUW/asr-user-manual

- Added AVIV ScoutRoute User Manual
- Added TDEI Account Registration guide
- Updated Contributing guide
- Added new tags
- Added images
- Added abbreviations
- Update utilities scripts

Author: uw-amy-bordenave

.cache/plugin/git-committers/page-authors.json

@@ -76,6 +76,8 @@ tags:
 ---
 ```
 
+**Tags**: Tags, restricted to the allowed tags listed in `mkdocs.yml`, are used for categorizing pages. The intended audience is tagged across two axes: Internal-vs-External and Developer-vs-User. Note that "External" implies that it is suitable for "Internal" audience as well, and that "User" implies that it is suitable for "Developer" audience as well. These are explicitly _not_ access restrictions; external users can access all content.
+
 **Note**: The `"    - Guide"` tag does not need to be added to guides, as that tag is inherited from the `.meta.yml` file in that directory.
 
 **Exception**: `docs/index.md` has title commented out to prevent "TCAT Wiki - TCAT Wiki" duplication.

.cache/plugin/privacy/assets/external/unpkg.com/mermaid@11/dist/mermaid.min.js

@@ -1,5 +1,3 @@
-.claude/
 local-storage/
 tcat-wiki.code-workspace
-CLAUDE.md
 *.wip

.github/copilot-instructions.md

@@ -1,3 +1,5 @@
+<!-- @format -->
+
 # TCAT Wiki
 
 This repository contains the files used to create the [TCAT Wiki](https://taskarcenteratuw.github.io/tcat-wiki/) using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/).

.gitignore

@@ -1,5 +1,8 @@
 ---
 title: Contributing
+tags:
+    - Internal
+    - Developer
 ---
 
 <!-- @format -->
@@ -33,7 +36,9 @@ This section of the guide explains how to set up a Windows environment for contr
 1. Install [Visual Studio Code](https://code.visualstudio.com/)
 
     1. Install [YAML](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) plugin
+
     2. Install [Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one) plugin
+
     3. Install [EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
 
 2. Install mkdocs-material
@@ -82,7 +87,19 @@ This section of the guide explains how to set up a Windows environment for contr
 
 Refer to the documentation for [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) and the [MkDocs User Guide](https://www.mkdocs.org/user-guide/).
 
-### Screenshots
+### Images
+
+Where possible, follow these guidelines for images:
+
+1. Format: 24-bit `.png`
+
+2. Resizing: Scale images using `{ width="123" }`:
+
+    `![alt text](image.png){ width="300" }`
+
+Refer to [Material for MkDocs: Images](https://squidfunk.github.io/mkdocs-material/reference/images/) and [Material for MkDocs: Attribute Lists](https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#attribute-lists) for more information.
+
+#### Screenshots
 
 For creating screenshots with a consistent style, Firefox DevTools is to be used.
 
@@ -114,7 +131,44 @@ For creating screenshots with a consistent style, Firefox DevTools is to be used
 
 4. Resulting screenshots will fit exactly within the 2px outside border present in the following screenshot templates:
 
-    1. [Screenshot (Landscape)](../../../resources/images/template/screenshot-landscape.png)
-    2. [Screenshot (Portrait)](../../../resources/images/template/screenshot-portrait.png)
+    1. [Screenshot (Landscape)](../../resources/images/template/screenshot-landscape.png)
+
+    2. [Screenshot (Portrait)](../../resources/images/template/screenshot-portrait.png)
+
+5. It is recommended to remove all embedded metadata, such as with the use of [ExifToolGUI](https://exiftool.org/gui/).
+
+#### Image Annotations
+
+For creating image annotations with a consistent style, follow these guidelines.
+
+1. Highlight box
+
+    2. Use: Indicating an area of focus in an image.
+
+    3. Style
+
+        1. Padding: `2px` distance from highlighted selection
+
+        2. Outline
+
+            1. Width: `1px`
+
+            2. Color: `#4B2E83` ("Husky "Purple")
+
+        3. Fill
+
+            1. Color: `#FFC700` ("Spirit Gold")
+
+            2. Opacity: `0.25`
+
+    4. Example:
+
+        ![alt text](../../resources/images/tdei-portal/login-h-forgot-password.png){ loading=lazy }
+
+    5. Naming convention: For images with highlights, append `-h-$highlightedFeature`
+
+        1. Example: `login.png` → `login-h-forgot-password.png`
+
+#### QR Codes
 
-5. It is recommended to remove embedded metadata, such as with the use of [ExifToolGUI](https://exiftool.org/gui/).
+1. Create QR codes using [Project Nayuki's QR Code generator library](https://github.com/nayuki/QR-Code-generator).

README.md

@@ -2,6 +2,8 @@
 title: About
 ---
 
+<!-- @format -->
+
 # About
 
 The TCAT Wiki is built using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/).

docs/about/guides/CONTRIBUTING.md

@@ -1,3 +1,5 @@
+<!-- @format -->
+
 <!-- ---
 Note: `title` is not defined for this page so that the title "TCAT Wiki" is output instead of "TCAT Wiki - TCAT Wiki"
 title: TCAT Wiki