i am just going to throw in 2 points from my personal experience:

1) "negative space": tell people also "what it's not" to avoid misconceptions

2) keeping documentation updated with code

discuss! :)