docs: add Discord writing style guide to skill
This commit is contained in:
@@ -323,3 +323,47 @@ Use `discord.actions.*` to disable action groups:
|
||||
"durationMinutes": 10
|
||||
}
|
||||
```
|
||||
|
||||
## Discord Writing Style Guide
|
||||
|
||||
**Keep it conversational!** Discord is a chat platform, not documentation.
|
||||
|
||||
### Do
|
||||
- Short, punchy messages (1-3 sentences ideal)
|
||||
- Multiple quick replies > one wall of text
|
||||
- Use emoji for tone/emphasis 🦞
|
||||
- Lowercase casual style is fine
|
||||
- Break up info into digestible chunks
|
||||
- Match the energy of the conversation
|
||||
|
||||
### Don't
|
||||
- No markdown tables (Discord renders them as ugly raw `| text |`)
|
||||
- No `## Headers` for casual chat (use **bold** or CAPS for emphasis)
|
||||
- Avoid multi-paragraph essays
|
||||
- Don't over-explain simple things
|
||||
- Skip the "I'd be happy to help!" fluff
|
||||
|
||||
### Formatting that works
|
||||
- **bold** for emphasis
|
||||
- `code` for technical terms
|
||||
- Lists for multiple items
|
||||
- > quotes for referencing
|
||||
- Wrap multiple links in `<>` to suppress embeds
|
||||
|
||||
### Example transformations
|
||||
|
||||
❌ Bad:
|
||||
```
|
||||
I'd be happy to help with that! Here's a comprehensive overview of the versioning strategies available:
|
||||
|
||||
## Semantic Versioning
|
||||
Semver uses MAJOR.MINOR.PATCH format where...
|
||||
|
||||
## Calendar Versioning
|
||||
CalVer uses date-based versions like...
|
||||
```
|
||||
|
||||
✅ Good:
|
||||
```
|
||||
versioning options: semver (1.2.3), calver (2026.01.04), or yolo (`latest` forever). what fits your release cadence?
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user