Merge pull request #463 from neural-loop/taxonomies

Taxonomies

Author: neural-loop

.github/ISSUE_TEMPLATE/new-software.yml

@@ -16,6 +16,17 @@ body:
     validations:
       required: true
 
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      description: Which part of the Software Guide does this belong in? # Keep in sync with data/taxonomies/software-categories.json
+      options:
+        - SNN Framework
+        - Data Tool
+    validations:
+      required: true
+
   - type: textarea
     id: description
     attributes:
@@ -99,4 +110,4 @@ body:
         - Key features?
         - Who is it for?
     validations:
-      required: true
+      required: true

.github/workflows/main.yml

@@ -46,6 +46,9 @@ jobs:
       - name: Install npm dependencies
         run: npm ci
 
+      - name: Validate Taxonomy
+        run: node scripts/validateContentTaxonomy.js
+
       - name: Enforce Coding Standards
         run: |
           echo "Checking for decorative comments..."

archetypes/neuromorphic-hardware.md

@@ -1,21 +1,19 @@
 ---
-title: "{{ replace .Name "-" " " | title }}" # Hardware Title: Clear, include manufacturer (50-60 chars). E.g., "Loihi 2 - Intel"
-product_name: "{{ replace .Name "-" " " | title }}" # Short name used in card/spec-table headers, e.g. "Akida". Distinct from `title`, which includes the manufacturer.
-# Meta Description (SEO): 120-160 characters.
-# For someone searching for this hardware, what is its primary application (e.g., 'real-time AI') and its most standout feature (e.g., 'on-chip learning')?
-# What question does this hardware answer for a researcher or developer?
+title: "{{ replace .Name "-" " " | title }}"
+product_name: "{{ replace .Name "-" " " | title }}"
 description: "Explore [Hardware Name] by [Manufacturer], a neuromorphic chip designed for [key application like 'real-time AI processing' or 'low-power edge computing'] featuring [unique characteristic like 'on-chip learning']."
-image: "hardware-image.png" # Main image for the hardware. Place in this folder. Used for card and OG image.
+image: "hardware-image.png"
 draft: true
-active_product: true # Set to false if the product is End-of-Life or retired
-type: "neuromorphic-hardware" # Do not change
+active_product: true
+type: "neuromorphic-hardware"
+category: "uncategorized" # Scaffold field for future hardware taxonomy. Must match a key in data/taxonomies/hardware-categories.json.
 
 organization:
-  group_name: "Optional Research Group Name" # e.g., Brains in Silicon
-  org_logo: "manufacturer-logo.png" # Manufacturer/Org logo.
-  org_name: "Manufacturer/Organization Name" # e.g., Intel, Stanford
+  group_name: "Optional Research Group Name"
+  org_logo: "manufacturer-logo.png"
+  org_name: "Manufacturer/Organization Name"
   org_website: "https://manufacturer.com"
-  product_page_link: "https://manufacturer.com/product-page" # Direct link to official product page
+  product_page_link: "https://manufacturer.com/product-page"
   social_media_links:
     linkedin: "https://linkedin.com/company/manufacturer"
     twitter: "https://twitter.com/manufacturer_handle"
@@ -30,7 +28,7 @@ product:
   synapses: "Number or Approx. (e.g., 120 million max, 256 million)"
   weight_bits: "e.g., 8-bit, 1-4 bit configurable"
   activation_bits: "e.g., 1-bit (spikes), 16-bit (neuron state)"
-  on_chip_learning: true # or false
+  on_chip_learning: true
   power: "~X mW / W (typical or range)"
   release_year: YYYY
   release_date: "YYYY-MM-DD"
@@ -50,3 +48,4 @@ Describe the chip architecture, including number of cores, neuron types, synapse
 
 ## Software and Tools
 What software development kits (SDKs), frameworks, or tools are used to program or interface with this hardware?
+

archetypes/neuromorphic-software.md

@@ -1,22 +1,20 @@
 ---
-title: "Software Name - Purpose" # Software Title: Clear, include main purpose (50-60 chars for SEO). E.g., "Spyx - JAX-based SNN Library"
-type: "neuromorphic-software" # Do not change
-# Meta Description (SEO): 120-160 characters.
-# This appears in search results. Briefly describe the software: What is it? Who is it for? What problem does it solve?
-# Highlight key features or benefits.
+title: "Software Name - Purpose"
+type: "neuromorphic-software"
+category: "" # REQUIRED. Must exactly match a key in data/taxonomies/software-categories.json (e.g., "snn-framework", "data-tool"). Do NOT create a subfolder.
 description: "Discover [Software Name], a [Python/C++] framework/tool for [primary function, e.g., SNN simulation, event data processing] designed for [target users, e.g., researchers, developers] in neuromorphic computing."
-logo: "software-logo.png" # Software logo. Place in this software's folder, or reference from static/images/.
+logo: "software-logo.png"
 website: "https://official-website.com"
 dependencies: "Key dependencies (e.g., PyTorch, JAX, NumPy, C++17)"
 field_of_application: "e.g., Machine Learning, Neuroscience, Data Processing, Hardware Interface, Robotics"
-source_code: "https://github.com/org/repo" # This URL is now used to automatically fetch the star count for sorting.
-pypi_id: "" # e.g., "snntorch". Leave empty if not applicable.
+source_code: "https://github.com/org/repo"
+pypi_id: ""
 license: "e.g., MIT, GPL-3.0, AGPL-3.0, Apache-2.0, custom"
-supports_hardware: false # Set to true if it directly supports or deploys to neuromorphic hardware platforms
-supports_NIR: false # Set to true if it supports the Neuromorphic Intermediate Representation
-language: "Python" # Primary programming language(s)
+supports_hardware: false
+supports_NIR: false
+language: "Python"
 maintainer: "Maintainer Name or Organization"
-draft: true # Set to false when ready to publish
+draft: true
 ---
 
 ## Overview

config/_default/menus.en.toml

@@ -53,7 +53,7 @@ description = "A community-driven peer review program for open and reproducible
 [[main]]
 parent = "explore-resources"
 name = "Hacking Hours"
-url = "/neuromorphic-computing/software/hacking-hours/"
+url = "/neuromorphic-computing/hacking-hours/"
 weight = 6
 [main.params]
 icon = "fas fa-terminal"
@@ -177,7 +177,7 @@ url = "/neuromorphic-computing/student-talks/"
 weight = 3
 [[footer_community]]
 name = "Hacking Hours"
-url = "/neuromorphic-computing/software/hacking-hours/"
+url = "/neuromorphic-computing/hacking-hours/"
 weight = 4
 [[footer_community]]
 name = "Contributors"

…mputing/software/hacking-hours/_index.md …orphic-computing/hacking-hours/_index.mdcontent/neuromorphic-computing/software/hacking-hours/_index.md renamed to content/neuromorphic-computing/hacking-hours/_index.md content/neuromorphic-computing/software/hacking-hours/_index.md renamed to content/neuromorphic-computing/hacking-hours/_index.md

@@ -1,8 +1,11 @@
 ---
-title: "Hacking Hours"
-description: "Join Jens Pedersen and guests for live Hacking Hour sessions, diving into neuromorphic software, coding practices, and collaborative problem-solving."
-type: "hacking-hours" 
-image: "images/hacking-hours-default-banner.png" 
+title: Hacking Hours
+description: >-
+  Join Jens Pedersen and guests for live Hacking Hour sessions, diving into
+  neuromorphic software, coding practices, and collaborative problem-solving.
+type: hacking-hours
+image: images/hacking-hours-default-banner.png
+url: /neuromorphic-computing/software/hacking-hours/
 ---
 
 Hacking Hours are live, interactive coding sessions dedicated to exploring the world of neuromorphic software. Hosted by Jens Pedersen, these sessions often feature guest developers from the community and industry to provide deep dives into specific neuromorphic frameworks, tools, and problem-solving techniques.
@@ -15,4 +18,4 @@ These sessions are more focused than our general community calls, aiming to prod
 
 A core goal of Hacking Hours is to improve the neuromorphic software ecosystem. Below is a preview of open-source projects that are actively looking for contributors. This is a great way to get involved and make a real impact on the tools we all use.
 
-{{< community-projects-mini-board >}}
+{{< community-projects-mini-board >}}

…-macireau-contributing-to-faery/index.md …-macireau-contributing-to-faery/index.mdcontent/neuromorphic-computing/software/hacking-hours/alexandre-macireau-contributing-to-faery/index.md renamed to content/neuromorphic-computing/hacking-hours/alexandre-macireau-contributing-to-faery/index.md content/neuromorphic-computing/software/hacking-hours/alexandre-macireau-contributing-to-faery/index.md renamed to content/neuromorphic-computing/hacking-hours/alexandre-macireau-contributing-to-faery/index.md

@@ -1,15 +1,20 @@
 ---
-title: "Alexandre Marcireau: Contributing to Faery"
+title: 'Alexandre Marcireau: Contributing to Faery'
 author:
-  - "Alexandre Marcireau"
-  - "Jens E. Pedersen"
-date: 2025-10-14
-description: "A guide on how to contribute to Faery with Alexandre Marcireau and host Jens E. Pedersen."
+  - Alexandre Marcireau
+  - Jens E. Pedersen
+date: 2025-10-14T00:00:00.000Z
+description: >-
+  A guide on how to contribute to Faery with Alexandre Marcireau and host Jens
+  E. Pedersen.
 upcoming: false
-video: "Wt8JPTs-fA8"
-image: "logo.png"
-type: "hacking-hours"
-software_tags: ["faery"]
+video: Wt8JPTs-fA8
+image: logo.png
+type: hacking-hours
+software_tags:
+  - faery
+url: >-
+  /neuromorphic-computing/software/hacking-hours/alexandre-macireau-contributing-to-faery/
 ---
 
 Have you ever had a problem with event cameras that you had no idea how to approach? You're not alone and we're gathering a community of people to help each other out in Faery.

…-macireau-contributing-to-faery/logo.png …-macireau-contributing-to-faery/logo.pngcontent/neuromorphic-computing/software/hacking-hours/alexandre-macireau-contributing-to-faery/logo.png renamed to content/neuromorphic-computing/hacking-hours/alexandre-macireau-contributing-to-faery/logo.png content/neuromorphic-computing/software/hacking-hours/alexandre-macireau-contributing-to-faery/logo.png renamed to content/neuromorphic-computing/hacking-hours/alexandre-macireau-contributing-to-faery/logo.png

@@ -1,15 +1,20 @@
 ---
-title: "Alexandre Marcireau: Faery API Hacking"
+title: 'Alexandre Marcireau: Faery API Hacking'
 author:
-  - "Alexandre Marcireau"
-  - "Jens E. Pedersen"
-date: 2024-10-29
-description: "A deep dive into hacking and extending the Faery API with Alexandre Marcireau and host Jens E. Pedersen."
+  - Alexandre Marcireau
+  - Jens E. Pedersen
+date: 2024-10-29T00:00:00.000Z
+description: >-
+  A deep dive into hacking and extending the Faery API with Alexandre Marcireau
+  and host Jens E. Pedersen.
 upcoming: false
-video: "bkwC0ygMous"
-image: "alexandre-marcireau-faery-api-hacking.jpg"
-type: "hacking-hours"
-software_tags: ["faery"]
+video: bkwC0ygMous
+image: alexandre-marcireau-faery-api-hacking.jpg
+type: hacking-hours
+software_tags:
+  - faery
+url: >-
+  /neuromorphic-computing/software/hacking-hours/alexandre-marcireau-faery-api-hacking/
 ---
 
 This Hacking Hour features Alexandre Marcireau, who, along with host Jens E. Pedersen, dives deep into the Faery event processing library. The session focuses on practical API hacking, exploring how to extend and customize Faery for specific neuromorphic data processing tasks.