Skip to main content

Developer Page Specifications

Module Overview

Editorial vs Coverage boundary. 6 article types. 9 topic taxonomy. Industry-first IA. isPractical flag rules.

Complete

Editorial is the platform’s curated-knowledge surface. It publishes analysis, founder stories, sector reports, ecosystem context, and practical signals — NOT a generic blog, NOT a news aggregator, NOT marketing content. Every article passes through a 3-gate editorial review (sourcing · ecosystem relevance · founder utility) before publishing. Articles are also the densest cross-module mention surface in the platform after Coverage.

Module identity

Editorial vs Coverage
Coverage articles MUST anchor to a parent CalendarEvent (parentEventId required). Editorial articles do NOT — they are theme-driven (market analysis, sector reports, founder stories). The structural test: parentEventId present → Coverage; absent → Editorial. Misclassification breaks cross-module reverse-lookups + wrong JSON-LD subtype.
Article types (EditorialType enum)
news (hard news, time-sensitive) · analysis (interpretive long-form) · commentary (opinion + editorial perspective) · interview (Q&A format with named subject) · profile (founder/startup deep-dive) · guide (practical how-to, drives isPractical=true).
Topic taxonomy (EditorialTopic enum)
funding · sector-report · founder-story · ecosystem · policy · product · market-expansion · leadership · hiring. Single value per article (drives sidebar suggestion + cross-module suggestion logic).
isPractical flag
When true, the article is a how-to with founder takeaways. Drives the suppression rule in §2.G (cross-module Files suggestion is suppressed when isPractical=true because the Article itself IS the practical reference).

Routes (5 public)

  1. /:lang/editorial — listing (latest + featured + most-read + categories + topics)
  2. /:lang/editorial/{slug} — article details
  3. /:lang/editorial/categories/{categorySlug} — category-scoped listing
  4. /:lang/editorial/topics/{topicSlug} — topic/tag-scoped listing
  5. /:lang/editorial/authors/{authorSlug} — author page (all articles by one author)