Skip to content

TAGS.md

Latest commit

 

History

History
204 lines (145 loc) · 10.7 KB

TAGS.md

File metadata and controls

204 lines (145 loc) · 10.7 KB
Raw

Tag Taxonomy

Comprehensive tag reference for all steering documents in this repository. Use tags to find documents by language, purpose, tool, or framework.

Tag Categories

Language Tags

Tags for programming languages and markup languages:

Tag Description Documents
bash Bash scripting Bash Scripting
css CSS/SCSS styling CSS Formatting
graphql GraphQL schemas GraphQL Schema
javascript JavaScript language JavaScript Formatting
json JSON data format JSON Formatting
markdown Markdown markup Markdown Formatting
python Python language Python Formatting
scss SCSS preprocessor CSS Formatting
shell Shell scripting Bash Scripting
sql SQL queries SQL Formatting
terraform Terraform IaC Terraform Configuration
typescript TypeScript language TypeScript Formatting
yaml YAML configuration YAML Formatting
html HTML markup Coming soon

Purpose Tags

Tags for document purpose and functionality:

Tag Description Documents
api API development GraphQL Schema, API Development Patterns
best-practices Best practices Security Best Practices, Testing Best Practices
code-generation Guides code generation JavaScript, TypeScript, Python
containers Container technologies Dockerfile
database Database patterns SQL Formatting, Database Query Patterns
devops DevOps practices Docker, Terraform, YAML
documentation Documentation standards Markdown Formatting
formatting Code formatting rules All code-formatting documents
iac Infrastructure as Code Terraform Configuration
infrastructure Infrastructure patterns Terraform Configuration
linux Linux systems Bash Scripting
queries Query patterns SQL Formatting
schema Schema definitions GraphQL Schema
scripting Scripting languages Bash Scripting
security Security practices Security Best Practices
testing Testing standards Testing Best Practices
validation Input validation Security Best Practices
vulnerabilities Vulnerability prevention Security Best Practices
performance Performance optimization Coming soon
accessibility Accessibility standards Coming soon

Tool Tags

Tags for development tools and utilities:

Tag Description Documents
docker Docker containers Dockerfile
dockerfile Dockerfile syntax Dockerfile
eslint ESLint linting JavaScript Formatting
git Git version control Git Commit Standards
graphql GraphQL API GraphQL Schema
terraform Terraform IaC Terraform Configuration
prettier Prettier formatting Coming soon
github-actions GitHub Actions CI/CD Coming soon
webpack Webpack bundling Coming soon
vite Vite build tool Coming soon

Framework Tags

Tags for frameworks and libraries:

Tag Description Documents
django Django framework Django Patterns
express Express.js Node.js/Express Patterns
fastapi FastAPI framework FastAPI Patterns
nodejs Node.js runtime Node.js/Express Patterns
react React framework React Component Patterns
vue Vue.js framework Vue Component Patterns
angular Angular framework Coming soon
nextjs Next.js Coming soon

Standard Tags

Tags for coding standards and conventions:

Tag Description Documents
code-quality Code quality standards Code Review Standards, Error Handling
code-review Code review practices Code Review Standards
commits Commit conventions Git Commit Standards
components Component patterns React, Vue
config Configuration files JSON Formatting, YAML Formatting
debugging Debugging practices Logging Standards
deployment Deployment patterns Environment Config
environment Environment management Environment Config
error-handling Error handling Error Handling Standards
exceptions Exception handling Error Handling Standards
framework Framework patterns All framework documents
frontend Frontend development React, Vue
logging Logging patterns Logging Standards
observability Observability practices Logging Standards
patterns Design patterns API Development Patterns
pep8 Python PEP 8 standard Python Formatting
quality Quality standards Code Quality documents, Testing
query-patterns Query patterns Database Query Patterns
rest REST API patterns API Development Patterns
styles Styling standards CSS Formatting
types Type systems TypeScript Formatting
version-control Version control Git Commit Standards
web Web development Django

Using Tags

Finding Documents by Tag

  1. Browse this document to see all documents with a specific tag

  2. Use the main README tag search for quick navigation

  3. Check category READMEs for tag-filtered lists within categories

Tag Combinations

Find documents by combining tags:

  • javascript + formatting = JavaScript formatting documents

  • python + code-generation = Python code generation guides

  • typescript + types = TypeScript type system documents

Adding Tags to New Documents

When contributing, include relevant tags in your document's frontmatter:

---
title: "Your Document Title"
description: "Brief description"
tags: ["language", "purpose", "tool", "framework"]
---

Tag Guidelines

Choosing Tags

  • Be specific: Use precise tags that describe the document

  • Use existing tags: Check this taxonomy before creating new tags

  • Limit quantity: Use 3-5 relevant tags per document

  • Include language: Always tag with the primary language

Tag Naming Conventions

  • Lowercase: All tags use lowercase letters

  • Hyphens: Use hyphens for multi-word tags (e.g., github-actions)

  • No spaces: Never use spaces in tags

  • Descriptive: Tags should be self-explanatory

Contributing Tags

When adding new tags:

  1. Check if an existing tag covers your need

  2. Propose new tags in your pull request

  3. Update this taxonomy document

  4. Add the tag to relevant category READMEs

See CONTRIBUTING.md for detailed guidelines.

Tag Statistics

Current tag distribution:

  • Language tags: 13 active, 1 planned

  • Purpose tags: 18 active, 2 planned

  • Tool tags: 6 active, 4 planned

  • Framework tags: 6 active, 2 planned

  • Standard tags: 23 active

Total documents: 27 active steering documents

Last updated: This taxonomy is maintained as new documents are added to the repository.