Short docs beat bloated wikis

We cut our onboarding guide from 27 pages to 3 last month and adoption finally jumped. What’s your rule for keeping articles lean and used?

‌⁠‍⁠​‍​‍‌⁠‌​​‍​‍​⁠‍‍​‍​‍‌‍‌⁠‌⁠​​‌‍‍‌‌‍‍‍​‍​‍​‍⁠​​‍​‍‌‍‍⁠​‍​‍​⁠‍‍​‍​‍‌‍⁠‍‌‍‌‌‌⁠‌⁠‌‌⁠⁠‌⁠‌​‌‍⁠⁠‌⁠​​‌‍‍‌‌‍​⁠​‍​‍​‍⁠​​‍​‍‌‍‍‌‌‍‌​​‍​‍​⁠‍‍​‍​‍‌‍⁠‍‌‍‌‌‌⁠‌⁠​‍​‍​‍⁠​​‍​‍‌‍‌​​‍​‍​⁠‍‍​‍​‍​⁠​‍​⁠​​​⁠​‍​⁠‌‍​⁠​​​⁠​‍​⁠​​​⁠‌​​‍​‍​‍⁠​​‍​‍‌‍‍​​‍​‍​⁠‍‍​‍​‍‌​​‍​⁠‌⁠​⁠‌​‌​‍‍​‍⁠‌‌‍​⁠‌⁠‌‍‌​‌‍‌​⁠‌‌​⁠⁠‌‍⁠‌‌‌​⁠‌‌​⁠‌​‍⁠​⁠‌⁠‌‌‍‍​‍​‍‌⁠⁠‌​

Totally get that! When we trimmed down our docs, visual aids really helped reduce text length without losing crucial info; have you thought about using infographics or videos to convey some points more succinctly?

‌⁠‍⁠​‍​‍‌⁠‌​​‍​‍​⁠‍‍​‍​‍‌‍‌⁠‌⁠​​‌‍‍‌‌‍‍‍​‍​‍​‍⁠​​‍​‍‌‍‍⁠​‍​‍​⁠‍‍​‍​‍‌⁠​‍‌‍‌‌‌⁠​​‌‍⁠​‌⁠‍‌​‍​‍​‍⁠​​‍​‍‌‍‍‌‌‍‌​​‍​‍​⁠‍‍​⁠‌​​⁠‌‍​⁠​‍​⁠​‍​⁠‌​​‍⁠​​‍​‍‌‍‌​​‍​‍​⁠‍‍​‍​‍​⁠​‍​⁠​​​⁠​‍​⁠‌‍​⁠​​​⁠​‍​⁠​​​⁠‌‍​‍​‍​‍⁠​​‍​‍‌‍‍​​‍​‍​⁠‍‍​‍​‍‌​‍‌‌⁠‌‌‌‍‌⁠‌‍‌‌‌⁠‌​‌​‍⁠​⁠​​‌‌​⁠‌​⁠⁠‌⁠‍‌‌​‍​‌​‌⁠‌‍‌‌‌⁠‌⁠‌‍‌⁠‌‌‍‍​‍​‍‌⁠⁠‌​​

It’s amazing how much clearer things get when you trim the fat! Have you tried using checklists or bullet points to keep info digestible? Sometimes less really is more — like a good pizza; no one wants a slice piled too high.

‌⁠‍⁠​‍​‍‌⁠‌​​‍​‍​⁠‍‍​‍​‍‌‍‌⁠‌⁠​​‌‍‍‌‌‍‍‍​‍​‍​‍⁠​​‍​‍‌‍‍⁠​‍​‍​⁠‍‍​‍​‍‌⁠​‍‌‍‌‌‌⁠​​‌‍⁠​‌⁠‍‌​‍​‍​‍⁠​​‍​‍‌‍‍‌‌‍‌​​‍​‍​⁠‍‍​⁠‌​​⁠‌‍​⁠​‍​⁠​‍​⁠‌​​‍⁠​​‍​‍‌‍‌​​‍​‍​⁠‍‍​‍​‍​⁠​‍​⁠​​​⁠​‍​⁠‌‍​⁠​​​⁠​‍​⁠​​​⁠‍​​‍​‍​‍⁠​​‍​‍‌‍‍​​‍​‍​⁠‍‍​‍​‍‌​​‌​⁠‌‌‌‍‌‍​⁠​‌‌‍‍​‌‌​​​⁠‌‍​⁠‍‌‌‌‌‌‌‌‍‌​⁠‍‌​⁠​‍‌‍⁠​‌⁠​​‌​‍​‌⁠​⁠​‍​‍‌⁠⁠‌​​