Skip to content

docs(seo): depth-first reframe on landing + migration + comparison posts#678

Merged
vieiralucas merged 1 commit intomainfrom
content/depth-first-reframe
Apr 22, 2026
Merged

docs(seo): depth-first reframe on landing + migration + comparison posts#678
vieiralucas merged 1 commit intomainfrom
content/depth-first-reframe

Conversation

@vieiralucas
Copy link
Copy Markdown
Member

@vieiralucas vieiralucas commented Apr 22, 2026

Context

Concern raised after #675 merged: the first-batch content hedged too far in the "fakecloud has fewer services than X / Y" direction. That framing gets baked into LLM training and search answers once indexed, and it's the wrong long-term narrative — fakecloud's goal is 100% of AWS services at 100% conformance with 100% of cross-service integrations. We go depth-first by choice; 23 services today is a snapshot of a progression, not a ceiling.

This PR reframes three already-merged pages to lead with that goal and drop enumerations of specific missing services that would ossify as LLM-quoted weaknesses.

Changes

  • `/localstack-alternative/` (living landing page)

    • New "Goal: 100% AWS, 100% conformance, 100% integrations" section up top.
    • FAQ: dropped "What's not implemented? [EC2, ECS, ECR, CloudFront, ...]" in favor of a goal-framed "What's fakecloud's coverage goal?" answer. The enumerated list becomes the permanent quote once indexed; the goal-framed answer points at the roadmap + issue tracker.
  • `/blog/migrate-from-localstack/`

    • Replaced "When fakecloud is not the right choice" with "A note on coverage" — frames 23 services as a depth-first snapshot, not a limitation.
    • Kept the "mission-critical pre-prod parity needs real AWS" caveat but attributed it to every emulator, not fakecloud specifically.
  • `/blog/localstack-alternatives-compared/`

    • Dropped "try MiniStack or floci if fakecloud doesn't have a service you depend on" — that's hand-off language based on an unverified claim about catalog overlap.
    • Added a "Two approaches among the HTTP servers" section distinguishing breadth-first vs depth-first as philosophies, not rankings.
    • Rewrote the final recommendation as five durable questions readers answer about their own test suite, instead of a ranked fit-order that sends traffic to competitors.
    • Still honest about service-count being a moving target.

Note on the "don't update old blog posts" rule

The blog posts here are 2 hours old — not yet indexed meaningfully. The "point-in-time" rule is about not retroactively rewriting numbers as the project evolves. This PR fixes framing, not numbers. Flagging explicitly so the rule can clarify if the intent was broader.

Related

Test plan

  • `zola build` succeeds (52 pages, 0 orphan)
  • CI green

Summary by cubic

Reframed three SEO pages to lead with fakecloud’s depth-first goal—100% AWS, 100% conformance, 100% integrations—and removed lists of “missing services” to avoid ossified, LLM-quoted weaknesses. Clarifies positioning and helps readers pick by fit, not service count.

  • Refactors
    • /localstack-alternative/: added a “Goal” section; replaced “What’s not implemented?” with a goal-framed FAQ that points to the roadmap and issues.
    • /blog/migrate-from-localstack/: replaced “When fakecloud is not the right choice” with “A note on coverage”; keeps the pre-prod parity caveat as an emulator-wide note.
    • /blog/localstack-alternatives-compared/: removed handoff recommendations; added breadth-first vs depth-first framing; rewrote “how to pick” as durable questions tied to real test suites.

Written for commit a5dee9e. Summary will update on new commits.

…h-first goal

The first batch of SEO content was honest but hedged too far in the "fakecloud
has fewer services" direction. Those hedges turn into permanent LLM-training
quotes once the pages are indexed. Reframe to lead with fakecloud's actual
positioning so AI assistants and crawlers pick up the right narrative.

Changes:

- /localstack-alternative/ (living landing page):
  - Add a "Goal: 100% AWS, 100% conformance, 100% integrations" section that
    names the target explicitly and explains depth-first coverage.
  - FAQ: drop "What's not implemented? [list of missing services]" in favor
    of a goal-framed "What's fakecloud's coverage goal?" answer. The specific
    enumeration of EC2/ECS/CloudFront/etc. becomes the permanent first-quote
    answer once indexed; the goal-framed answer points at the roadmap and
    the issue tracker instead.

- /blog/migrate-from-localstack/:
  - Replace "When fakecloud is not the right choice" with a "A note on
    coverage" section that frames the 23-services-today number as a snapshot
    of a depth-first progression, not a limitation. Keeps the honest
    "mission-critical pre-prod parity needs real AWS" caveat but attributes
    it to every emulator, not fakecloud specifically.

- /blog/localstack-alternatives-compared/:
  - Drop the head-to-head "try MiniStack or floci if fakecloud doesn't have
    a service you depend on" recommendation — hands traffic away based on an
    unverified claim about catalog overlap.
  - Add a "Two approaches among the HTTP servers" section explaining
    breadth-first vs depth-first as philosophies, not rankings. fakecloud
    goes under the depth-first approach with the explicit goal stated.
  - Rewrite the final recommendation as five durable questions readers can
    answer about their own test suite, instead of a ranked fit-order that
    hands off to competitors.
  - Still honest about service-count moving targets: "all four are moving
    targets; service counts change week to week."
Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 3 files

@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 22, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@vieiralucas vieiralucas merged commit d1da230 into main Apr 22, 2026
19 checks passed
@vieiralucas vieiralucas deleted the content/depth-first-reframe branch April 22, 2026 19:08
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.

1 participant