Gregory's ServerI like the "show, dont tell" paradigm.
That is, I'd rather give examples of code snippets that show how to use my tools, and give the briefest possible explanation of how it works.
I also worry about the "documentation gets stale" aspect, so ive been tempted to have the documentation snippets integrated with a test suite so I'm confident they are correct if my build passes.
But that might be overkill.