-
Notifications
You must be signed in to change notification settings - Fork 169
Reference, Hugo Taxonomies
Hugo defines Taxonomies that may be used in the front matter of Markdown documents. This site uses the following taxonomies:
Topics should always be included in front matter for all content. Topics are divided into two levels. These levels are the primary method for how the site navigation for content is built. These levels must be one of the following options and must appear exactly as follows:
level1: Modern App Basics
level2: Modern Development Concepts
level1: Modern App Basics
level2: DevOps Practices
level1: Modern App Basics
level2: Kubernetes Platform
level1: Modernizing Legacy Applications
level2: Deconstruction
level1: Modernizing Legacy Applications
level2: Packaging, Operating, and Outside Enhancements
level1: Agile Transformation and Practices
level2: Agile Development
level1: Agile Transformation and Practices
level2: Team Tips
level1: Building Modern Applications
level2: Microservice Patterns
level1: Building Modern Applications
level2: Frameworks and Languages
level1: Building Modern Applications
level2: Modern Development Practices
level1: Building Modern Applications
level2: Services
level1: Deploying Modern Applications
level2: Packaging and Publishing
level1: Deploying Modern Applications
level2: CI/CD, Release Pipelines
level1: Managing and Operating Applications
level2: Metrics, Tracing, and Monitoring
level1: Managing and Operating Applications
level2: Preparing and Deploying Kubernetes Workloads
level1: Building Kubernetes Runtime
level2: Application Platform on Kubernetes
level1: Building Kubernetes Runtime
level2: Building Your Kubernetes Platform
level1: Managing and Operating Kubernetes
level2: Monitoring and Observing Kubernetes
level1: Managing and Operating Kubernetes
level2: Kubernetes Architecture
level1: Managing and Operating Kubernetes
level2: Preparing and Deploying Kubernetes Workloads
level1: Securing Kubernetes
level2: Backup and Restore
level1: Securing Kubernetes
level2: Access and Security
Tags appear in the tags
section of the front matter. Usually tags refer to a specific technology or technology area. 'tags' are free form at this point and can be anything. They are not surfaced directly at this point and mostly aid in search. That said, there are some guidelines:
- Tags should be capitalized -- Tags should start with a capital letter, and if multi-word, each major word should also be capitalized (title case).
-
Tags should still be pretty general -- In most cases, tags should not refer to a very particular tool or product. Instead, at this point, and in most cases, tags should remain pretty "top-level". For example: a piece on VMware Tanzu Build Service could include tags
VMware
,Tanzu
, andTanzu Build Service
. Since we don't have a lot of content to organize forTanzu Build Service
, it is probably okay to just useTanzu
for the tag.
API
, Security
, Java
, Docker
, knative
, Microservices
, Python
, .NET
, Tanzu
, Automation
, Ingress
, Event Streaming
, Containers
, Observability
, Reactive
, Serverless
, etc
Use the team
taxonomy to attribute one or more authors to a piece of content.
Content may be tagged as featured: true
along with a weight
in the front matter to appear in the Featured section on the home page. Only three will appear at once.
- Start Here
- Prewriting / Ideation
- Setting Up You Environment to Create Content
- Drafting Content
- Editing Content
- Testing Content Locally
- Committing Content to be Published
- Content Next Steps
- Start Here
- Prewriting / Ideation
- Tools you need (hint: it's Google Docs)
- Drafting Content
- Editing Content
- Contributing Content