I have feedback in the past that people don't like diagrams upfront, because it presents a finished solution.