Skip to content

docs: GitHub Marketplace listing runbook — plans, requirements, launch sequence#67

Merged
BunsDev merged 1 commit into
mainfrom
docs/marketplace-listing
Jul 8, 2026
Merged

docs: GitHub Marketplace listing runbook — plans, requirements, launch sequence#67
BunsDev merged 1 commit into
mainfrom
docs/marketplace-listing

Conversation

@BunsDev

@BunsDev BunsDev commented Jul 7, 2026

Copy link
Copy Markdown
Member

What

The go-to-market companion to #66 (billing entitlements): docs/marketplace-listing.md, the runbook for listing the hosted App on GitHub Marketplace.

  • Plans to publish: Hosted Starter ($99) and Hosted Team ($399) with 14-day trials, mapped to the adapter's tier ids; Dedicated stays sales-led off-Marketplace (custom contracts don't fit Marketplace plan mechanics) and is provisioned via explicit [[installations]] entries.
  • Requirements checklist mapped to current state — the webhook/enforcement/deletion requirements are already shipped; what remains is publisher verification, public App, support/privacy URLs, and the listing itself.
  • Listing copy drawn from HOSTED.md.
  • Launch sequence ending with the require_plan = true flip, grandfathering existing beta installations until they purchase.
  • Records the plan-name classification constraint (names must keep their tier word) and the Stripe fallback if listing review stalls.

Why

Marketplace is the most seamless billing channel for this product: purchase events key on the same installation/account units the adapter already uses for tenancy, so a purchase provisions service with zero operator action.

Docs-only change; pricing.md gains a cross-link.

Testing

Docs only — no code paths affected.

Copilot AI review requested due to automatic review settings July 7, 2026 12:12

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

This PR adds a GitHub Marketplace listing runbook for the hosted OpenCoven GitHub App and cross-links it from the pricing document, aiming to document plans, requirements, and a launch sequence for Marketplace go-to-market.

Changes:

  • Add docs/marketplace-listing.md runbook covering Marketplace rationale, plans, requirements, listing copy, and launch steps.
  • Add a cross-link from docs/pricing.md to the new Marketplace listing runbook.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File Description
docs/pricing.md Adds a link pointing readers to the Marketplace listing runbook.
docs/marketplace-listing.md Introduces a Marketplace listing runbook (plans, checklist, copy, and launch sequence).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/marketplace-listing.md
Comment thread docs/marketplace-listing.md
Comment thread docs/marketplace-listing.md
Comment thread docs/marketplace-listing.md
Comment thread docs/marketplace-listing.md
…h sequence

The go-to-market half of billing entitlements: which plans get listed (Starter/
Team with 14-day trials; Dedicated stays sales-led off-Marketplace), the
listing requirements checklist mapped to what the adapter already enforces,
listing copy drawn from HOSTED.md, and the launch sequence including the
require_plan flip with beta grandfathering. Notes the plan-name classification
constraint and the Stripe fallback.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Val Alexander <bunsthedev@gmail.com>
@BunsDev BunsDev force-pushed the docs/marketplace-listing branch from d7d865b to 6038ae2 Compare July 8, 2026 20:18
@BunsDev BunsDev merged commit 9271bf8 into main Jul 8, 2026
1 check passed
@BunsDev BunsDev deleted the docs/marketplace-listing branch July 8, 2026 20:25
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