Skip to content

docs: lead with explorable prototype workflows - #2283

Open
pmcelhaney wants to merge 2 commits into
mainfrom
readme-explorable-prototype
Open

docs: lead with explorable prototype workflows#2283
pmcelhaney wants to merge 2 commits into
mainfrom
readme-explorable-prototype

Conversation

@pmcelhaney

Copy link
Copy Markdown
Collaborator

No description provided.

Copilot AI review requested due to automatic review settings August 3, 2026 21:00

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Repositions the README’s introduction to emphasize Counterfact as a tool for building explorable prototype workflows (stateful, retryable, error-path-aware) before a backend is available, and updates the “Start with the workflow you need” table to match that framing.

Changes:

  • Updates the primary README tagline and opening paragraphs to lead with “explorable prototype” workflows for frontend development.
  • Adds guidance on when simpler fixtures are sufficient vs. when Counterfact is the better fit.
  • Rewrites the workflow table entries to prioritize prototype exploration and UI-independent debugging use cases.

Comment thread README.md Outdated
![MIT License](https://img.shields.io/badge/license-MIT-blue) [![Coverage Status](https://coveralls.io/repos/github/counterfact/api-simulator/badge.svg)](https://coveralls.io/github/counterfact/api-simulator) ![Swagger 2.0](https://img.shields.io/badge/Swagger-2.0-85EA2D) ![OpenAPI 3.0–3.2](https://img.shields.io/badge/OpenAPI-3.x-6BA539) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/counterfact/api-simulator)

## Turn an OpenAPI document into an editable, stateful local API.
## Build an explorable prototype before your backend exists.
Copilot AI review requested due to automatic review settings August 3, 2026 21:02

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

Suppressed comments (1)

README.md:7

  • The top-level heading ends with a period, which is inconsistent with the rest of the README section headings (they omit trailing punctuation) and can look odd in TOCs/anchor previews.
## Prototype your UI before investing in backend development.

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