Add tags to the documentation.

Author: mrbiggred

AGENTS.md

@@ -36,6 +36,7 @@ This is the **Weekly Dev Chat** website, a static site built with MkDocs Materia
     ├── .authors.yml           # Author metadata (chris, norm, omar)
     ├── index.md               # Homepage
     ├── join.md                # How to join the chat
+    ├── tags.md                # Tags index page (auto-populated by tags plugin)
     ├── past_topics.md         # Archived topics (excluded from build)
     ├── hosts/
     │   └── index.md           # Current hosts page
@@ -76,9 +77,14 @@ This is the **Weekly Dev Chat** website, a static site built with MkDocs Materia
 2. **blog**: Enables blog functionality
    - Blog directory: Root (`.`)
    - Pagination: 3 posts per page
+3. **tags**: Enables tag-based categorization and browsing
+   - Tags index page: `docs/tags.md` (configured via `tags_file`)
+   - Tags are defined in blog post frontmatter
+   - The plugin auto-generates a tag listing with links to all posts for each tag
 
 ### Navigation Structure
 - Home (index.md)
+- Tags (tags.md)
 - Join (join.md)
 - Hosts (hosts/index.md)
 - Past Hosts (past-hosts/index.md)
@@ -113,9 +119,25 @@ title: "Your Blog Post Title"
 date: YYYY-MM-DD
 authors:
  - chris | norm | omar  # One or more authors
+categories:
+  - Category Name  # e.g., Security, Culture, Career, Technical
+tags:
+  - tag-name  # Lowercase, hyphenated tags for topic filtering
 ---
 ```
 
+### Categories and Tags
+
+**Categories** are broad topic groupings displayed on blog post cards. Common categories include:
+- Security
+- Culture
+- Career
+- Technical
+
+**Tags** are specific topic labels used for fine-grained filtering. Tags appear on the **Tags** page (`docs/tags.md`), which is auto-generated by the Material for MkDocs tags plugin. Each tag links to a listing of all posts with that tag.
+
+Examples of tags: `cybersecurity`, `pair-programming`, `ai`, `open-source`, `testing`, `devops`
+
 ### Post Content Template
 ```markdown
 TOPIC_INTRODUCTION_HERE
@@ -265,6 +287,7 @@ The following are ignored:
 ### For Content Changes
 - `docs/index.md` - Homepage content
 - `docs/join.md` - Join instructions
+- `docs/tags.md` - Tags index page (content auto-generated by tags plugin)
 - `docs/hosts/index.md` - Current hosts information
 - `docs/sponsors/index.md` - Sponsor information
 - `docs/posts/YYYY/MM/DD/index.md` - Blog posts
@@ -292,6 +315,10 @@ The following are ignored:
    date: YYYY-MM-DD
    authors:
     - chris
+   categories:
+     - Category Name
+   tags:
+     - relevant-tag
    ---
    ```
 4. **Add content** following the template
@@ -345,7 +372,7 @@ The following are ignored:
 1. **Never modify** `.github/workflows/ci.yml` unless explicitly requested - deployment is automated and stable
 2. **Always test locally** before pushing changes to main branch
 3. **Blog posts must follow** the date-based directory structure: `YYYY/MM/DD/`
-4. **Frontmatter is required** for all blog posts (title, date, authors)
+4. **Frontmatter is required** for all blog posts (title, date, authors, categories, tags)
 5. **Images for blog posts** should be placed in the same directory as the post's `index.md`
 6. **The site uses** Material for MkDocs theme - refer to https://squidfunk.github.io/mkdocs-material/ for advanced features
 7. **Custom CSS** should be minimal and placed in `docs/stylesheets/extra.css`
@@ -393,6 +420,16 @@ The blog plugin is configured with:
 
 For more blog plugin features, see: https://squidfunk.github.io/mkdocs-material/plugins/blog/
 
+## MkDocs Material Tags Plugin Details
+
+The tags plugin is configured with:
+- **Tags file**: `docs/tags.md` - serves as the tags index page
+- **Auto-generated listing**: The `<!-- material/tags -->` marker in `tags.md` is replaced with a tag cloud linking to per-tag post listings
+- **Frontmatter integration**: Tags are defined per-post in the `tags:` frontmatter field
+- **Navigation**: The Tags page is linked in the site navigation bar
+
+For more tags plugin features, see: https://squidfunk.github.io/mkdocs-material/plugins/tags/
+
 ## Troubleshooting
 
 ### Build Fails
@@ -422,6 +459,7 @@ For more blog plugin features, see: https://squidfunk.github.io/mkdocs-material/
 - **MkDocs Documentation**: https://www.mkdocs.org
 - **Material for MkDocs**: https://squidfunk.github.io/mkdocs-material/
 - **Blog Plugin**: https://squidfunk.github.io/mkdocs-material/plugins/blog/
+- **Tags Plugin**: https://squidfunk.github.io/mkdocs-material/plugins/tags/
 - **GitHub Pages**: https://docs.github.com/en/pages
 - **Site**: https://weeklydevchat.github.io
 

README.md

@@ -11,6 +11,7 @@ A static website for the Weekly Dev Chat community - a weekly virtual developer
 
 This is a static site built with [MkDocs Material](https://squidfunk.github.io/mkdocs-material/) and hosted on GitHub Pages. The site features:
 - Weekly blog posts for Tuesday chat topics
+- Tag-based browsing to filter posts by topic
 - Host information and community guidelines
 - Sponsor information
 - Automatic deployment via GitHub Actions
@@ -95,6 +96,10 @@ These scripts will:
    date: YYYY-MM-DD
    authors:
     - chris
+   categories:
+     - Category Name
+   tags:
+     - relevant-tag
    ---
    ```
 
@@ -126,6 +131,7 @@ These scripts will:
     ├── .authors.yml           # Author metadata
     ├── index.md               # Homepage
     ├── join.md                # How to join
+    ├── tags.md                # Tags index page (auto-populated by tags plugin)
     ├── hosts/                 # Current hosts
     ├── past-hosts/            # Past hosts
     ├── sponsors/              # Sponsors
@@ -187,6 +193,7 @@ When updates are available, Dependabot creates pull requests automatically. Revi
 - [MkDocs Documentation](https://www.mkdocs.org)
 - [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)
 - [Material Blog Plugin](https://squidfunk.github.io/mkdocs-material/plugins/blog/)
+- [Material Tags Plugin](https://squidfunk.github.io/mkdocs-material/plugins/tags/)
 - [GitHub Pages Documentation](https://docs.github.com/en/pages)
 
 ## Community