Discord¶
Use this file for Discord communication. Marin has two main Discord modes: summaries and responses.
Pick The Right Mode¶
- Write summaries for observers.
- Write responses for collaborators already in the thread.
- Assume messages may be read later by people outside the immediate exchange.
Summaries¶
Summaries are messages meant to provide context to people who may not have it. They may be contributors or interested on-lookers.
Assume This Reader¶
- Assume a technically literate ML or LLM reader.
- Assume they are not following day-to-day work.
- Assume they generally know what Marin is; these posts will be in the Marin discord.
Optimize For¶
- Make ongoing work legible quickly.
- Surface the main takeaway and the concrete result.
- Point readers to deeper artifacts such as issues, PRs, or reports.
Write This Way¶
- Start with the main takeaway.
- Include the concrete result or change.
- Briefly explain what the work is.
- Link to the relevant artifact instead of re-explaining everything.
- Keep it short, usually a few paragraphs at most.
Keep The Tone¶
- Stay calm, factual, and slightly polished.
- Avoid hype, marketing tone, and excessive internal jargon.
Responses¶
Assume This Reader¶
- Assume the reader is an active Marin collaborator in the thread.
- Assume they have context unless what they are specifically asking for it.
Optimize For¶
- Move the work forward.
- Answer the question directly.
- Clarify the next useful detail with minimal drag.
Write This Way¶
- Be direct and to the point.
- Use technical shorthand when it genuinely helps.
- Answer the question first, then elaborate if needed.
- Avoid unnecessary verbosity and performative framing.
Keep The Tone¶
- Stay conversational but grounded.
- Be helpful without sounding performative.
- Avoid hype and exaggerated reactions.
Shared Rules¶
- Prefer concrete observations over speculation.
- Label speculation clearly when you need it.
- Avoid inside jokes or references that exclude later readers.
- Link to artifacts instead of repeating long explanations.