Editorial Calendar

This directory contains the editorial calendar for content planning and scheduling.

Structure

Each quarter has its own YAML file:

calendar/
├── 2025-Q1.yml
├── 2025-Q2.yml
├── 2025-Q3.yml
├── 2025-Q4.yml
└── README.md

YAML Format

quarter: "2025-Q1"
theme: "Overall quarterly theme (optional)"

months:
  january:
    theme: "Monthly theme"
    posts:
      - week: 1
        type: blog              # blog, social, video
        title: "Post Title"
        description: "Brief description"
        topics: ["topic1", "topic2"]
        status: planned         # planned, draft, review, published, cancelled
        assigned: author-id
        due_date: 2025-01-07
        publish_date: 2025-01-10
        platforms:              # For social/cross-posting
          - twitter
          - linkedin
        priority: medium        # low, medium, high
        notes: "Any additional notes"

  february:
    theme: "February Theme"
    posts:
      - week: 1
        type: video
        title: "Video Title"
        status: planned

Status Values

Status	Description
`planned`	Scheduled but not started
`draft`	Work in progress
`review`	Submitted for review
`published`	Live and published
`cancelled`	Cancelled or postponed

Content Types

Type	Description	Template
`blog`	Blog post	`templates/blog-post.md`
`social`	Social media post	`templates/social-post.md`
`video`	Video script	`templates/video-script.md`
`newsletter`	Email newsletter	-
`series`	Multi-part series	-

Platforms

Common platform identifiers:

blog - Main blog/website
twitter / x - Twitter/X
linkedin - LinkedIn
youtube - YouTube
threads - Threads
newsletter - Email newsletter
instagram - Instagram
bluesky - Bluesky

Best Practices

Plan quarterly: Create calendar files at the start of each quarter
Review weekly: Update status and adjust dates as needed
Track dependencies: Note when content depends on other work
Balance content: Mix content types and topics
Buffer time: Build in flexibility for unexpected content

Viewing the Calendar

The calendar YAML files are machine-readable. You can:

View raw YAML in any text editor
Use GitHub’s YAML rendering
Build a calendar view with a custom script
Import into project management tools

Automation

The CI workflow validates calendar files on PR:

YAML syntax validation
Required field checking
Date format validation
Status value validation

Adding Content to the Calendar

Open the appropriate quarter file
Find the target month and week
Add a new entry following the YAML format
Submit a PR for review

Example:

- week: 3
  type: blog
  title: "Getting Started with Feature Flags"
  status: planned
  assigned: your-username
  due_date: 2025-01-15
  publish_date: 2025-01-20
  platforms:
    - blog
    - twitter
    - linkedin