Really interested to know if you embed ASCII diagrams in your source code / store engineering diagrams in your project repos?
My take is that the closer documentation is to the code the more useful it is and more likely it will be updated. Would be great to have your feedback on a side project in this area, a chrome extension / web service to turn Umlet diagrams into SVGs when you're viewing them through GitHub. Check it out at https://github.com/CalumJEadie/umlet-github.
