Why?
Throughout Coda’s history, we’ve gone through different phases of writing and reviewing briefs. There was a time when Catalyst (and its predecessor) was mostly product topics. More recently, much of the brief writing and reviewing happens within teams. That’s generally positive since small, autonomous teams work well at Coda. There are three reasons for rolling out this brief now:
Scale the team’s best practices — we have many new Codans and they are rightly asking the question of best practices that we’ve learned over the years. This brief accumulates many of those learnings. Build faster at higher quality — our market is competitive and we need to continuously raise our game. When executed well, using this brief should raise the quality and increase the velocity of our product. Communicate better as a team — we’re building an incredibly interconnected product. Given that, we need to ensure we’re efficiently communicating changes across our organization. Centralizing these briefs in a Slack channel will makes it easier to follow the improvements to the product. Steps
Write the , , and . Send to braintrust & #pd-product-docs on Slack. Write the , and send to braintrust and #pd-product-docs on Slack. Coordinate with your PMM partner on launch comms. Test, launch, iterate, and launch improvements. Update Log
May 1, 2023 — updated team roles to include Driver and Interested per decision making update April 21, 2023 — updated section to clarify scenarios/examples and provide doc examples. April 19, 2023 — simplified several sections of and based on feedback. April 19, 2023 — added key image/gif prompt to page. April 19, 2023 — added links to key marketing docs and processes. April 18, 2023 — pulled out the press release section into it’s own page given the importance and also in an effort to make sure we continuously evolve it. April 18, 2023 — wrote the ‘Why?’ section of the page to explain the rationale.