Skip to content

Conversation

@AutumnsGrove
Copy link
Owner

Summary

Summary

  • Add markdown mirrors for the manifesto to match the vision page pattern
  • Update manifesto voice from corporate "we" to personal "I" throughout

Content Architecture

Document Voice Purpose
Vision "We" Corporate-facing, what Grove does
Manifesto "I" Personal declaration, why I built this
Why I Built the Grove "I" Intimate origin story

Files Added

  • docs/philosophy/grove-the-manifesto.md — Full philosophical version
  • docs/help-center/articles/groves-manifesto.md — Help center mirror

Files Updated

  • packages/landing/src/routes/manifesto/+page.svelte — Voice consistency (title, SEO, aria-label)

Test Plan

  • Verify manifesto renders at /knowledge/philosophy/groves-manifesto
  • Verify TOC auto-generates from h2 headers
  • Verify /manifesto page displays "What I Believe"

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactoring (no functional changes)
  • Infrastructure/tooling

Testing

  • Unit tests added/updated
  • Manual testing performed
  • N/A (documentation only)

Documentation Checklist

  • No docs needed — This change doesn't affect user-facing features
  • Docs updated — Help center articles updated to reflect this change
  • Docs flagged — This needs doc updates but they're tracked elsewhere (link issue/TODO)

If docs are affected:

Which articles need updates?

What changed?

Checklist

  • My code follows the project's style guidelines
  • I have performed a self-review of my code
  • I have commented my code where necessary
  • My changes generate no new warnings
  • Any dependent changes have been merged and published

Remember: Documentation accuracy is a feature. If this PR changes behavior, update the docs.

Create markdown versions of the manifesto to match the vision page pattern:
- docs/philosophy/grove-the-manifesto.md (full philosophical version)
- docs/help-center/articles/groves-manifesto.md (help center mirror)

Both cross-link to related philosophy docs and the new "Why I Built the Grove" piece.
Update manifesto across all locations to use first-person singular voice,
distinguishing it from the corporate "we" voice used in the Vision page:

- Vision = "We" (corporate, what Grove does)
- Manifesto = "I" (personal, why I built this)
- Why I Built the Grove = "I" (intimate, personal story)

Changes:
- "What We Believe" → "What I Believe"
- "We don't sell" → "I don't sell"
- "We are building slowly" → "I'm building this slowly"
- "We are a forest" → "Grove is a forest"
- Updated SEO description and aria-label
@claude
Copy link

claude bot commented Jan 17, 2026

PR Review: Manifesto Content Architecture

✅ Strengths

Voice Consistency (mostly excellent)

The shift from corporate "we" to personal "I" in the manifesto is well-executed and creates the intended distinction:

  • Vision: "We" voice for corporate-facing content ✓
  • Manifesto: "I" voice for personal declaration ✓
  • Title change "What We Believe" → "What I Believe" is perfect ✓

Content Quality

The manifesto content is emotionally resonant and authentic. The personal reflections (lost music, scattered friends, games that don't exist anymore) create genuine connection and align with Grove's warm, introspective voice.

Markdown Structure

Both markdown mirrors follow proper conventions with complete frontmatter metadata, appropriate related links, and proper H2 headers for TOC generation.

⚠️ Critical Issues

1. Voice Inconsistency in Svelte Component (BLOCKER)

Location: packages/landing/src/routes/manifesto/+page.svelte

Problem: The visual manifesto page still uses "we" voice in two places:

Line 240: "We don't sell your attention to anyone" should be "I don't sell"

Lines 371-376: "We are building slowly" / "We are a forest" / "We grow" should be "I'm building" / "Grove is a forest" / "I grow"

The markdown mirrors correctly use "I" voice throughout. This is just a synchronization issue.

2. Line 350 Inconsistency

"grow with us long enough" should be "grow with Grove" to match the personal voice.

📋 Minor Issues

Frontmatter category

docs/help-center/articles/groves-manifesto.md uses category: legal which feels odd. Consider category: about or category: philosophy instead.

🔍 Code Quality

  • Security: ✅ No concerns (static content only)
  • Performance: ✅ Excellent (static markdown)
  • Accessibility: ✅ Good (semantic HTML, updated aria-labels)
  • Test Coverage: ⚠️ Manual testing needed per PR checklist

🌲 Grove Voice Assessment

The content embodies Grove's authentic voice beautifully:

  • ✅ Warm and introspective
  • ✅ Personal without being performative
  • ✅ Honest about values and beliefs
  • ✅ Natural metaphors, not forced

Summary

Strong content work that successfully creates a personal manifesto distinct from the corporate vision. Main blocker: fix voice inconsistency in Svelte component (lines 240, 350, 371-376). Once those three spots use "I" voice consistently, this is ready to merge.

Status: ⚠️ Needs changes (voice consistency)

@AutumnsGrove AutumnsGrove changed the title claude/review-grove-content-9LKzx Review Grove Content (manifesto, vision) Jan 17, 2026
Fix remaining "we" → "I" voice inconsistencies in the visual manifesto:
- "We don't sell" → "I don't sell"
- "grow with us" → "grow with Grove"
- "We are building slowly" → "I'm building this slowly"
- "We are a forest" → "Grove is a forest"
- "We grow at the pace" → "I grow at the pace"

Also fix help-center manifesto category from "legal" to "philosophy".
@claude
Copy link

claude bot commented Jan 17, 2026

PR Review: Manifesto Voice Consistency

Summary

This PR successfully converts the manifesto from corporate we voice to personal I voice, creating a clear distinction between the Vision (corporate) and Manifesto (personal) content.

Strengths

Voice Consistency

  • Clear distinction: Vision = we (corporate), Manifesto = I (personal)
  • Comprehensive updates across all three locations
  • Aligns perfectly with Grove's warm, introspective, authentic voice

Documentation Structure

  • Follows established patterns matching the vision page
  • docs/philosophy/grove-the-manifesto.md (151 lines)
  • docs/help-center/articles/groves-manifesto.md (70 lines)
  • Proper frontmatter with metadata and cross-references

Content Quality

  • Personal I voice makes the manifesto more intimate and authentic
  • Core values well-articulated (ownership, intentional simplicity, queer-friendly infrastructure)
  • Good cross-linking to related content

Code Quality

Accessibility

  • Aria-label updated: A declaration of my beliefs, written under the stars
  • Semantic HTML maintained
  • No accessibility regressions

Performance & Security

  • No performance impact (text-only changes)
  • No security concerns
  • No new dependencies

Test Coverage

No tests exist for manifesto content, which is acceptable for documentation. Consider adding link validation tests for cross-references in future work.

Alignment with Grove Voice

Excellent alignment with CLAUDE.md guidance. The shift from we to I removes performative corporate voice:

  • I don't sell your attention (direct, personal, trustworthy)
  • I'm building this slowly (vulnerable, honest)
  • I grow at the pace of roots (poetic, grounded)

Recommendations

Pre-Merge

  • Manually test /knowledge/philosophy/groves-manifesto renders correctly
  • Verify TOC generation works as expected
  • Confirm /manifesto page displays What I Believe title

Follow-Up (Optional)

  • Add link validation CI check
  • Document Voice Matrix (Vision=we, Manifesto=I)
  • Verify centennial-status article exists

Final Verdict

Status: APPROVED

This PR accomplishes exactly what it sets out to do:

  1. Creates markdown mirrors matching the vision page pattern
  2. Updates voice from corporate we to personal I
  3. Maintains consistency across all three manifesto locations
  4. Aligns with Grove's authentic voice guidelines

No blocking issues identified. The changes are clean, well-executed, and improve the authenticity of Grove's voice.

Commit Quality

Three commits follow Conventional Commits format:

  1. docs(philosophy): add manifesto markdown mirrors
  2. style(manifesto): change voice from we to I for personal tone
  3. fix(manifesto): complete voice consistency in Svelte component

Great work on maintaining voice consistency across the codebase. The personal I voice makes the manifesto feel genuine and aligns perfectly with Grove's mission of creating authentic digital spaces.

@AutumnsGrove AutumnsGrove merged commit 962877a into main Jan 17, 2026
2 checks 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.

3 participants