Skip to content

Cut and rewrite AI-sounding copy on the cheat sheet and site - #11

Merged
AdiRishi merged 2 commits into
mainfrom
claude/de-slop-copy-a45bg1
Oct 12, 2026
Merged

AdiRishi merged 2 commits into
mainfrom
claude/de-slop-copy-a45bg1

Conversation

@AdiRishi

@AdiRishi AdiRishi commented Oct 12, 2026 •

Copy link
Copy Markdown
Owner

Requested by Adi · project thread

Before: parts of the cheat sheet and site read like AI-generated text. There were taglines and kicker labels that restated their heading, intros that repeated what the badges already said, tips that told readers nothing new, and filler jokes in the sample document. The writing also leaned on em-dash asides, "not X but Y" lines and puffery like "beautifully typeset".

After: less text overall (net −37 lines of copy across two commits). What remains says the same facts in plainer sentences. No behaviour changes. Section ids, the H1 and the heading structure are unchanged.

How: the first rule was to delete anything that wasn't needed, and only then to reword what stayed.

Removed

  • The "At a glance" and "Questions" kickers above headings that already say the same thing.
  • The closing CTA's kicker and body paragraph. The headline and the button remain.
  • The hero intro, down from three sentences to one: "CommonMark, GitHub Flavored Markdown, math and diagrams. Every example is editable."
  • The parts of the chapter intros that repeated the section badges or the section list.
  • Tips that told readers nothing new: "blank line around headings", "four spaces also make a code block" (the paragraphs section already says this), and "RenderMD's Table button inserts a starter".
  • The FAQ filler: "now used everywhere from GitHub READMEs to notes apps…".
  • The empty-state kicker. Its paragraph is now one short line.
  • From the sample document: the joke tasks ("Change the world / Take a nap"), the dreams SQL block, the "Magic" ★ column, the "make it yours" sign-off, the "READMEs love…" line and most of the intro.

Reworded

Where Before After
Hero specimen ## Proof, not promise … > Write like nobody's rendering. ## Weekly notes … > Review on Friday.
Closing CTA Go write something worth reading. Write markdown and see it typeset as you go.
Empty preview A blank page, full of promise. Nothing to render yet.
Loading skeleton H1 Beautiful markdown, rendered instantly. Read and write markdown in your browser.
Home <title> RenderMD — Beautiful markdown, rendered instantly RenderMD: Free markdown viewer and editor
Meta, manifest, OG alt "read it beautifully typeset" "read it as a typeset page"
Tips and FAQ em-dash asides, "for maximum compatibility", "perfect for…" plain sentences

Worth a look: the home <title> and the meta descriptions change what shows in search results.

pnpm check and pnpm test pass locally.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WVKbHBxvZ5orACztnaRUAm

Plainer wording in the cheat sheet hero, closing CTA, tips, FAQ and
support labels, the sample document, empty state, loading skeleton and
meta descriptions. Same facts and features, fewer em-dash asides,
taglines and filler.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WVKbHBxvZ5orACztnaRUAm
@AdiRishi AdiRishi self-assigned this Oct 12, 2026
@coderabbitai

coderabbitai Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: afd31721-ed2c-412e-8237-7c8b0ee529e7

📥 Commits

Reviewing files that changed from the base of the PR and between 53cb488 and 15ac975.


📒 Files selected for processing (17)
  • public/manifest.json
  • src/features/cheatsheet/components/ClosingCta.tsx
  • src/features/cheatsheet/components/Faq.tsx
  • src/features/cheatsheet/components/Hero.tsx
  • src/features/cheatsheet/components/QuickReference.tsx
  • src/features/cheatsheet/content/chapters/basics.ts
  • src/features/cheatsheet/content/chapters/beyond.ts
  • src/features/cheatsheet/content/chapters/gfm.ts
  • src/features/cheatsheet/content/faq.ts
  • src/features/cheatsheet/content/support.ts
  • src/features/cheatsheet/data.ts
  • src/features/cheatsheet/seo.ts
  • src/features/workspace/WorkspaceSkeleton.tsx
  • src/features/workspace/panes/preview/EmptyState.tsx
  • src/features/workspace/state/sample.md
  • src/lib/seo.ts
  • src/routes/index.tsx

✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment Ready!

Application Preview URL Status
Render MD Visit Preview ✅ Ready

Drop kickers that repeat their heading, the closing CTA's body text,
redundant tips and chapter-intro clauses, the empty-state label and
the sample document's extra SQL block and sign-off line.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WVKbHBxvZ5orACztnaRUAm
@AdiRishi AdiRishi changed the title Rewrite AI-sounding copy on the cheat sheet and site Cut and rewrite AI-sounding copy on the cheat sheet and site Oct 12, 2026
@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment Ready!

Application Preview URL Status
Render MD Visit Preview ✅ Ready

@AdiRishi
AdiRishi merged commit 9d88e05 into main Oct 12, 2026
2 of 3 checks passed
@AdiRishi
AdiRishi deleted the claude/de-slop-copy-a45bg1 branch October 12, 2026 13:36
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