Skip to content

docs: Promotion playbook, submission kit, and launch drafts#98

Open
jrosskopf wants to merge 7 commits into
mainfrom
claude/flapi-promotion-strategy-fgb85u
Open

docs: Promotion playbook, submission kit, and launch drafts#98
jrosskopf wants to merge 7 commits into
mainfrom
claude/flapi-promotion-strategy-fgb85u

Conversation

@jrosskopf

@jrosskopf jrosskopf commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fact-checks the promotion playbook against the source tree and corrects two claims (SQL-injection safety scoped to typed-param prepared-statement sites; the scanner is a config-time tool-description linter, not a runtime firewall)
  • Adds server.json for the official MCP Registry plus docs/promotion/SUBMISSION_KIT.md with verified, copy-paste metadata and per-channel submission steps
  • Adds ready-to-post launch drafts: Show HN (with first comment + pushback Q&A), five subreddit posts, DuckDB Discord, dbt forum, newsletter pitch, and two publish-ready blog posts (flagship REST+MCP narrative; typed-params security deep-dive)
  • Adds docs/promotion/TRACKER.md execution checklist; license-metadata bug filed as Wheel metadata declares Apache-2.0 but the project license is BSL 1.1 #97 (wheels claim Apache-2.0, repo is BSL 1.1 — fix before launch)

Test plan

  • All technical claims in the copy verified against src/ (prepared-statement pipeline, per-tool RBAC, telemetry opt-out flags, MCP transport, license)
  • Maintainer review of tone/positioning before anything is posted externally

🤖 Generated with Claude Code


View with Codesmith Autofix with Codesmith
Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.

claude and others added 4 commits July 13, 2026 14:32
- Community-by-community plan (Reddit, HN, SO, Discords, forums)
- MCP registry + awesome-list submission checklist
- Positioning hooks per audience (MCP, data eng, self-host, security)
- Launch sequence and anti-spam guardrails
…anifest

- Fact-check playbook claims against source; scope the SQL-injection claim
  to typed-param prepared-statement sites and correct the scanner wording
- Add server.json for the official MCP Registry (io.github.datazoode/flapi)
- Add docs/promotion/SUBMISSION_KIT.md: verified metadata + per-channel steps
- Add docs/promotion/TRACKER.md execution checklist (license bug: #97)
- Add launch drafts: Show HN (+pushback Q&A), Reddit (r/mcp, r/DuckDB,
  r/selfhosted, r/dataengineering, r/opensource), DuckDB Discord, dbt forum,
  newsletter pitch, flagship blog post, security deep-dive
- Note awesome-selfhosted license constraint (BSL 1.1 not accepted)
- punkpeye PR submitted (punkpeye/awesome-mcp-servers#10023)
- wong2 list does not accept PRs; documented mcpservers.org/submit form fields
- docs/promotion/assets/demo.tape: reproducible VHS script — uvx install,
  REST curl with Basic auth, MCP tools/list and tools/call on the same config
- docs/promotion/assets/flapi-demo.gif: 36s, 1200x720, 825 KB
- Embed the GIF at the top of Readme.md; tick off Week-0 blockers in TRACKER.md
…ackaging)

All real recordings via VHS with committed tapes and demo project trees:
- flapi-demo-agent.gif: Claude Code answering questions through flAPI MCP
  tools (Basic auth, per-tool RBAC) — requires fix #100
- flapi-demo-bigquery.gif: agent on top of BigQuery public data with typed
  prepared-statement params; the model never writes SQL
- flapi-demo-pack.gif: flapi pack single-binary deploy, served from /tmp
- assets/README.md documents reproduction, and why SAP/SharePoint demos
  were not recorded (no live backend / no connector) rather than staged

Recording these surfaced and fixed two launch-blocking bugs: #100 (PR #102)
and #101 (PR #103).
- flapi-demo-sharepoint.gif: live Microsoft 365 SharePoint list attached
  as a DuckDB catalog (erpl_web, ATTACH ... TYPE sharepoint_lists), served
  as an MCP tool, analyzed by Claude Code — all real, credentials only via
  {{env.*}} references
- demo-projects/sharepoint/: reproducible config tree (no secrets)
- Playbook §6: add the Microsoft 365/SharePoint wedge alongside SAP
- assets/README.md: recording notes incl. seeded tracker rows and the
  Number >= 10 filter that hides erpl-web CI fixture rows
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