Forums
Forums are a common way for developers to engage in a self-service way within a community. The forum may or may not be owned and managed by a platform, but almost always thrive when they are user supported, providing an opportunity for more advanced API consumers to answer questions and support the needs of newer API consumers.
Also known as: Community, Discussions, Message Board
Example
Standards
- schema.org schema.org DiscussionForumPosting
- schema.org schema.org Comment
- W3C ActivityPub
- IETF Atom Syndication Format (RFC 4287)
- IETF Atom Threading Extensions (RFC 4685)
- W3C WebSub
Link Relations
replies— RFC 4685 (Atom Threading)alternate— RFC 8288 (Web Linking)
Governance Rules
info-contact-url(Spectral (oas-info-contact)) — A forum URL is a common value for info.contact.url when a provider prefers community channels over direct email.
Risk & Compliance
Security: Public forums can leak internal details (stack traces, tokens pasted by users, customer identifiers). Moderation policy and a posted code of conduct reduce abuse; PII redaction in support transcripts is essential.
Tools
- Discourse — Self-hosted forum (GPL-2.0)
- GitHub Discussions — Hosted Q&A / forum
- Stack Exchange API — Q&A platform API
- Discord — Real-time community
- Slack — Real-time community
- Vanilla Forums — Hosted forum
Suggested Metrics
active_posters_30d— Distinct users posting within a 30-day window.answered_question_rate— Share of questions marked answered or accepted.first_response_p50_hours— Median time from question post to first human reply.staff_reply_ratio— Fraction of threads with at least one provider-side response — signals investment in the community.
Example Implementations
- Stripe — Discord-based developer community linked from the docs.
- GitHub — GitHub Community Discussions across topical categories.
- Twilio — Stack Overflow tag plus a Discord server for SIGNAL community.
Related Properties
Tags
- SDKs