Tips & Best Practices

Writing Better Diagrams

✅ Keep it simple - Start with basic shapes and connections
✅ Use clear labels - Make text descriptive and concise
✅ Organize logically - Flow from left to right or top to bottom
✅ Test as you go - Use live preview to catch errors early
✅ Save often - Use history to preserve your work

Performance Tips

✅ Break up complex diagrams - Use multiple smaller diagrams instead of one huge one
✅ Limit node count - Keep diagrams under 50 nodes for best performance
✅ Use appropriate types - Choose the right diagram type for your data

Collaboration Tips

✅ Document your syntax - Add comments to explain complex sections
✅ Use consistent naming - Make it easy for others to understand
✅ Share exports - Provide SVG/PNG for stakeholders without Confluence access
✅ Version control - Save major changes to history before editing

Best Practices Summary

Do's ✅

• Start with sample diagrams

• Use live preview to check your work

• Save versions before major changes

• Choose appropriate diagram types

• Keep diagrams focused and simple

• Export for external sharing

Don'ts ❌

• Don't create overly complex diagrams

• Don't forget to save your work

• Don't ignore syntax errors

• Don't use the wrong diagram type

• Don't skip the preview step