# 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.
