Content authoring

Currently the tech and days websites share a similar structure. Here are instructions for the content authoring on both sites.

Content types

• •Notes: Short-form entries in content/notes/[year]/[month]/[day]/[slug].md
• •Posts: Long-form entries in content/posts/[year]/[month]/[day]/[slug].md (drafts in content/posts/drafts/)

Commands

From the repository root:

pnpm new tech note [--category <category>] [title]  # Create note on `tech`
pnpm new tech post [title]                          # Create post draft on `tech`
pnpm ship tech                                      # Ship post on `tech`

pnpm new days note [--category <category>] [title]  # Create note on `days`
pnpm new days post [title]                          # Create post draft on `days`
pnpm ship days                                      # Ship post on `days`

Style guide

There's a detailed writing style guide in style-guide.md. This guide is language-agnostic. Use it proactively when reviewing writing style.

Workflow

1. •Notes: Create → write → remove draft: true → commit
2. •Posts: Create draft → write/polish → pnpm ship → commit

For the detailed workflow, see workflow.md.