Skip to content

Standardize frontmatter metadata across documentation files #514

@BekahHW

Description

@BekahHW

Description

Many documentation files have inconsistent or repetitive keywords in their frontmatter metadata. This makes navigation and discoverability less effective.

Problems Identified

  • Repetitive keywords that don't add value
  • Inconsistent keyword formatting
  • Some files have excessive keyword lists while others have too few
  • Keywords don't always match the actual content

Tasks

  • Audit all markdown files in the docs/ directory for frontmatter metadata
  • Create a standardized set of keywords for different content types
  • Remove redundant/repetitive keywords
  • Add missing relevant keywords where appropriate
  • Ensure consistent formatting across all files
  • Document the keyword standards for future contributors

Example Files to Fix

  • Coffee table group guides have very long, repetitive keyword lists
  • Monthly challenge files have inconsistent metadata
  • Procedure files could use more specific keywords

Acceptance Criteria

  • All documentation files have clean, relevant keywords
  • Keywords follow a consistent pattern
  • Documentation for keyword standards is created
  • Site navigation and search work effectively

Metadata

Metadata

Assignees

No one assigned

    Labels

    DocsAddressing VC docsUp for GrabsAvailable for a contributor

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions