Merge pull request #20 from Mazizova/resources-taxonomy-overhaul

Add structured subcategory + facet taxonomy to the resource catalog

Author: Mazizova

.github/ISSUE_TEMPLATE/resource-books.yml

@@ -36,9 +36,24 @@ body:
     attributes:
       label: "Publication year"
       placeholder: "e.g. 2022"
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Books
+        - Blogs
+        - Newsletters
+        - Reports & Research
+        - Whitepapers
+        - Case Studies
+        - Podcasts & Videos
+        - Documentation Portals
+    validations:
+      required: true
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: beginner, advanced, practical, performance"
-      placeholder: "advanced, performance"
+      label: "Additional tags (optional)"
+      description: "Topic, audience, pricing — see the full list in RESOURCES.md. Comma-separated."
+      placeholder: "Performance, DBA, Paid"

.github/ISSUE_TEMPLATE/resource-community.yml

@@ -24,9 +24,22 @@ body:
       description: "1–2 sentences on what it is."
     validations:
       required: true
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Forums
+        - "Slack, Discord & IRC"
+        - Mailing Lists
+        - Reddit & Social
+        - Blog Aggregators
+        - Podcasts & Videos
+    validations:
+      required: true
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: blogs, news, forums, chat, support"
-      placeholder: "blogs, news"
+      label: "Additional tags (optional)"
+      description: "Platform, language, access — see the full list in RESOURCES.md. Comma-separated."
+      placeholder: "Forum, English, Open"

.github/ISSUE_TEMPLATE/resource-events.yml

@@ -42,9 +42,31 @@ body:
     attributes:
       label: "City, Country"
       placeholder: "e.g. Amsterdam, Netherlands"
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Foundation Events
+        - Community Calls
+        - Webinars
+        - Meetups
+        - Conferences
+        - Partner & Member Events
+        - Past Events & Recordings
+    validations:
+      required: true
+  - type: dropdown
+    id: organizer
+    attributes:
+      label: "Organizer"
+      options:
+        - OurSQL Foundation
+        - Community
+        - Member & Partner
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: conference, free, open-source"
-      placeholder: "conference, free"
+      label: "Additional tags (optional)"
+      description: "Comma-separated."
+      placeholder: "Free"

.github/ISSUE_TEMPLATE/resource-saas.yml

@@ -24,9 +24,22 @@ body:
       description: "1–2 sentences on what it is and why it belongs here."
     validations:
       required: true
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Managed Databases
+        - Monitoring SaaS
+        - Backup & Recovery SaaS
+        - Migration & Replication SaaS
+        - Developer Platforms
+        - Security & Compliance SaaS
+    validations:
+      required: true
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: managed, cloud, serverless"
-      placeholder: "managed, cloud"
+      label: "Additional tags (optional)"
+      description: "Cloud provider, compliance, pricing — see the full list in RESOURCES.md. Comma-separated."
+      placeholder: "AWS, SOC 2, Pay-as-you-go"

.github/ISSUE_TEMPLATE/resource-services.yml

@@ -24,9 +24,25 @@ body:
       description: "1–2 sentences on what they offer."
     validations:
       required: true
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Consulting
+        - Support
+        - Managed Services
+        - Migration Services
+        - Performance Tuning
+        - Architecture & HA Design
+        - Cloud & Kubernetes
+        - Security & Compliance
+        - Training Providers
+    validations:
+      required: true
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: consulting, support, enterprise"
-      placeholder: "consulting, support"
+      label: "Additional tags (optional)"
+      description: "Delivery, geography, technology — see the full list in RESOURCES.md. Comma-separated."
+      placeholder: "Remote, Global, MySQL"

.github/ISSUE_TEMPLATE/resource-software.yml

@@ -25,9 +25,28 @@ body:
       placeholder: "A drop-in MySQL replacement that..."
     validations:
       required: true
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Database Software
+        - Monitoring & Observability
+        - Backup & Recovery
+        - Replication & High Availability
+        - Proxies & Traffic Management
+        - Connectors & Drivers
+        - Database Management & GUI
+        - DevOps & Deployment
+        - Schema Management & Migration
+        - Testing & Benchmarking
+        - Security
+        - AI & Ecosystem Skills
+    validations:
+      required: true
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: open-source, server, proxy, sharding"
-      placeholder: "open-source, server"
+      label: "Additional tags (optional)"
+      description: "Compatibility, deployment, license — see the full list in RESOURCES.md. Comma-separated."
+      placeholder: "MySQL, Kubernetes, Open Source"

.github/ISSUE_TEMPLATE/resource-training.yml

@@ -29,9 +29,21 @@ body:
     attributes:
       label: "Author or organization"
       placeholder: "e.g. Kedar Vaijanapurkar"
+  - type: dropdown
+    id: subcategory
+    attributes:
+      label: "Subcategory"
+      options:
+        - Courses
+        - Workshops
+        - Certifications
+        - Academic Resources
+        - Training Providers
+    validations:
+      required: true
   - type: input
     id: tags
     attributes:
-      label: "Tags"
-      description: "Comma-separated. Suggested: free, online, video, dba, developer, certification"
-      placeholder: "free, online, developer"
+      label: "Additional tags (optional)"
+      description: "Format, level, pricing, language — see the full list in RESOURCES.md. Comma-separated."
+      placeholder: "Self-Paced, Beginner, Free"

README.md

@@ -73,6 +73,8 @@ hugo server -D
 
 `tools/generate-resource-dates.sh` builds `data/resource_added.yaml` — the "date added" for each resource, read from git history, used by the Recently Added section on `/resources/`. Re-run it any time you want that section to reflect the latest history; it also runs automatically in CI before every deploy.
 
+If you add a new taxonomy to `hugo.yaml`'s `taxonomies:` map, also run `tools/generate-taxonomy-term-layouts.sh` (and add the new plural name to the list inside it first) — Hugo doesn't reliably fall back to `layouts/_default/term.html` for individual term pages in this setup, so each taxonomy needs its own `layouts/<plural>/term.html`. These are committed to the repo, not generated in CI.
+
 Open [localhost:1313](http://localhost:1313) in your browser.
 
 ---

RESOURCES.md

@@ -60,45 +60,90 @@ aggregator-mysql-events.md       ← for aggregator pages without a specific dat
 title: "Resource Name"
 link: "https://example.com"
 description: "One or two sentences describing what it is."
-tags: ["tag1", "tag2"]
+subcategories: ["Database Software"]   # pick from the list for this section, see below
 ---
 ```
 
-**Books (leaf bundle with cover image):**
+Every resource also carries a handful of **tag facets** — small, controlled sets of values (not free text) used to power the filters on each category page. The field name in front matter must be the **plural** shown below — Hugo taxonomies require it. The full machine-readable list (including which URL each one filters to) lives in [`data/taxonomy_schema.yaml`](data/taxonomy_schema.yaml); this is the human-readable version of the same thing.
+
+Pick a `subcategories` value from your section's list, and set whichever facets apply — all are optional and multi-value (a resource can carry more than one).
+
+**`content/resources/software/`** — subcategories: Database Software · Monitoring & Observability · Backup & Recovery · Replication & High Availability · Proxies & Traffic Management · Connectors & Drivers · Database Management & GUI · DevOps & Deployment · Schema Management & Migration · Testing & Benchmarking · Security · AI & Ecosystem Skills
+```yaml
+compatibility: ["MySQL"]        # MySQL, MariaDB, Percona Server, TiDB, Vitess, HeatWave, Galera, Group Replication
+deployment: ["Self-Hosted"]     # Self-Hosted, Kubernetes, Docker, Cloud-Native, On-Premises
+pricing: ["Open Source"]        # Open Source, Commercial, Free, Paid, Enterprise
+```
+
+**`content/resources/saas/`** — subcategories: Managed Databases · Monitoring SaaS · Backup & Recovery SaaS · Migration & Replication SaaS · Developer Platforms · Security & Compliance SaaS
+```yaml
+cloud-providers: ["AWS"]        # AWS, Azure, GCP, Multi-Cloud, Private Cloud
+compliance: ["SOC 2"]           # SOC 2, HIPAA, GDPR, PCI DSS
+pricing: ["Pay-as-you-go"]      # Pay-as-you-go, Subscription, Free Tier Available
+compatibility: ["MySQL"]        # MySQL, MariaDB, Percona Server, TiDB, Vitess
+```
+
+**`content/resources/services/`** — subcategories: Consulting · Support · Managed Services · Migration Services · Performance Tuning · Architecture & HA Design · Cloud & Kubernetes · Security & Compliance · Training Providers
+```yaml
+delivery: ["Remote"]            # Remote, On-Site, Hybrid
+countries: ["Global"]           # a country name (e.g. "Germany"), or "Global" if not region-specific
+compatibility: ["MySQL"]        # MySQL, MariaDB, Percona Server, TiDB, Vitess, Galera
+foundation-status: ["Sponsor"]  # Foundation Member, Sponsor, Partner — only if it actually applies
+```
+
+**`content/resources/training/`** — subcategories: Courses · Workshops · Certifications · Academic Resources · Training Providers
+```yaml
+training-formats: ["Self-Paced"] # Self-Paced, Instructor-Led, Workshop, Certification, Practice Lab
+levels: ["Beginner"]             # Beginner, Intermediate, Advanced
+pricing: ["Free"]                # Free, Paid, Free Trial Available
+languages: ["English"]           # English, Spanish, Portuguese, German, Chinese, Other
+author: "Percona"                # optional
+```
+
+**`content/resources/books/`** (leaf bundle with cover image) — subcategories: Books · Blogs · Newsletters · Reports & Research · Whitepapers · Case Studies · Podcasts & Videos · Documentation Portals
 ```yaml
 ---
 title: "High Performance MySQL, 4th Edition"
 link: "https://..."
 description: "One or two sentences."
 authors: ["Silvia Botros", "Jeremy Tinley"]
 year: 2021
-tags: ["advanced", "performance"]
+subcategories: ["Books"]
+topics: ["Performance"]         # Administration, Development, Architecture, Replication, Performance, Security, Migration, Scaling, Other
+audiences: ["Advanced"]         # DBA, Developer, Architect, Beginner, Advanced
+pricing: ["Paid"]               # Free, Paid
 images:
   - cover.jpeg
 ---
 ```
 
-**Training — optional author field:**
+**`content/resources/events/`** — subcategories: Foundation Events · Community Calls · Webinars · Meetups · Conferences · Partner & Member Events · Past Events & Recordings — prefix the filename with the date
 ```yaml
-author: "Percona"
+date: 2026-09-11
+format: "in-person"             # or "online" — drives the card's Online/In-person badge
+city: "Amsterdam"                # optional, only for in-person events
+countries: ["Netherlands"]       # a country name, or "Global" for an online/worldwide event
+event_year: ["2026"]
+event-formats: ["In-Person"]     # In-Person, Online, Hybrid
+organizers: ["Community"]        # OurSQL Foundation, Community, Member & Partner
 ```
 
-**Events — additional fields:**
+**`content/resources/community/`** — subcategories: Forums · Slack, Discord & IRC · Mailing Lists · Reddit & Social · Blog Aggregators · Podcasts & Videos
 ```yaml
-date: 2026-09-11
-format: "in-person"   # or "online"
-city: "Amsterdam"
-country: "Netherlands"
-event_country: ["Netherlands"]
-event_year: ["2026"]
+platforms: ["Forum"]             # Forum, Slack, Discord, Mailing List, Reddit, Meetup, YouTube, Podcast
+languages: ["English"]           # English, Spanish, Portuguese, German, Chinese, Other
+access: ["Open"]                 # Open, Registration Required
+listing-status: ["Active"]       # Active, Archived
 ```
 
-**Press & News — additional fields:**
+**`content/resources/press/`** — additional fields:
 ```yaml
 date: 2026-05-27
 source: "Publication Name"
 ```
 
+> Slashes ("/") aren't safe inside a facet value — Hugo treats them as URL path separators and breaks the filter link. Use "&" or "," instead (e.g. "Slack, Discord & IRC", not "Slack / Discord / IRC").
+
 ---
 
 ## Option 2 — Open an issue