[ADR] Use Discourse for collaboration and feedback

Scenario

I’m collecting content that falls into several categories:

  • Research that’'s horizontally useful to other people for reference and to inform project decisions
  • Project-specific content which will elicit feedback from stakeholders. They are broadly distributed and participate asynchronously.

Must have

  • Access controls
  • Platform agnostic
  • bidirectional Interop with other apps so we can process the underlying content.

Did not choose

  • Sphinx is great for publishing but less flexible for collaboration because everyone has to use git.
  • Google docs are weak in comment thread management

Chose

  • Discourse meets the must haves easily and will serve as a collaboration until we get closer to publication

Limits

  • We will need to revisit this decision when we’re ready to deliver because Discourse does not handle billing or usage metering AFAIK.

As a bonus, the mobile client is really nice.