docs: add Discord writing style guide to skill
This commit is contained in:
parent
c54fcd1e74
commit
ca09078934
@ -323,3 +323,47 @@ Use `discord.actions.*` to disable action groups:
|
|||||||
"durationMinutes": 10
|
"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?
|
||||||
|
```
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user