Human
Design your commands for humans. Have a conversation. Speak the Siemens brand: Authentic, open and engaging.
Interactivity
- Offer interactive modes when developing primarily for human interaction
- Tell users which environment they are in (interactive / non-interactive)
- Use --no-input when you don't want to interact with your terminal
- Ensure users can exit anytime
Output
- Return brief response messages, e.g. x done / x created / x named / x not done / x not created / x not named
- Respond by repeating command words, e.g. createdevice = device created / device not created
- Give command suggestions
- Use everyday, understandable language
- Use color when necessary and with reason
- Use well-known symbols to boost clarity when supported
- Tell users when there are state changes
- Avoid buzz words and jargon
- Avoid emojis to express emotions to align with our brand voice and style