Skip to content

Label AI-written blog posts, add authorship page, and add a blog style guide - #10

Merged
schacon merged 2 commits into
mainfrom
cursor/blog-ai-authorship-header-3bb3
Aug 2, 2026
Merged

Label AI-written blog posts, add authorship page, and add a blog style guide#10
schacon merged 2 commits into
mainfrom
cursor/blog-ai-authorship-header-3bb3

Conversation

@schacon

@schacon schacon commented Aug 2, 2026

Copy link
Copy Markdown
Member

Changes

AI authorship labeling

  • Add an automated boolean to the blog frontmatter schema (site/src/content.config.ts), defaulting to false.
  • Show an authorship banner at the top of every blog post (site/src/pages/blog/[id].astro): automated posts get a prominent "This post was written by AI" banner with an AI badge; human posts get a subtle "Written by a human" banner. Both link to the new authorship page.
  • Add a small "Written by AI" tag next to the date on the blog index (site/src/pages/blog/index.astro).
  • Add /authorship/ (site/src/pages/authorship.astro), explaining that the book is written entirely by humans (per AGENTS.md), while some blog posts are automated to communicate project updates — and always labeled.
  • Mark both existing blog posts as automated: true (both were committed by Cursor Agent).

Blog style guide

  • Add site/BLOG_STYLE.md, a writing style guide for blog posts derived from the book's own voice — every trait is illustrated with a real sentence quoted from the book (second-person address, "let's" walkthroughs, rhetorical questions answered immediately, em-dash asides, sparing dry humor, one sentence per source line, and so on).
  • Rewrite both existing posts to follow the guide.
  • Add a "Blog posts are the exception — but read the style guide first" section to AGENTS.md requiring agents to load site/BLOG_STYLE.md before writing or editing any post, and to always set automated: true.
  • Point the "Writing a blog post" section of site/README.md at the guide.

Context

The blog can carry agent-generated update posts, but readers should never have to guess who wrote what, and the posts should read like the book's authors wrote them. This makes AI authorship explicit at the top of each post, gives the label a destination that spells out the policy, and pins the blog's voice to the book's.

Verified locally with npm run build and browser walkthroughs of the preview site:

AI banner at the top of a blog post
Authorship policy page
Rewritten
blog_ai_banner_and_authorship_page_walkthrough.mp4
rewritten_blog_posts_in_book_voice_walkthrough.mp4

Open in Web Open in Cursor 

cursoragent and others added 2 commits August 2, 2026 10:43
Co-authored-by: Scott Chacon <schacon@gmail.com>
…match

Co-authored-by: Scott Chacon <schacon@gmail.com>
@cursor cursor Bot changed the title Label AI-written blog posts and add an authorship policy page Label AI-written blog posts, add authorship page, and add a blog style guide Aug 2, 2026
@schacon
schacon marked this pull request as ready for review August 2, 2026 11:02
@cursor

cursor Bot commented Aug 2, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@schacon
schacon merged commit 6b7a71f into main Aug 2, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants