Thursday, 22 September 2011
A Thousand Words
When I find myself explaining a concept over and over again to the same or different members of my team, it is a signal that I need to draw a picture.
Often, I draw the picture for a few people before it clicks that I should put it on an A3 piece of paper and stick it on a wall or take a photo and send it around in an email.
In the case above, I was explaining mapping between model classes coming out of different layers of the application. All sorts of words were being used to refer to these objects and it was getting confusing.
This image has given us an explanation of where mapping classes exist; what models coming out of different layers are called; namespaces to be used when creating or referring to mappers and models; and a common language for technical discussion.
To write that in a document would be long and cumbersome.
When you aren't explaining it in code, explain it in pictures.
Apple started a user experience trend many iOSes ago when it accepted Settings changes and did not ask for confirmation. Once the chang...
Five years ago, everybody seemed to want to have the word "architect" in their title. Firstly, they all needed a title and having...
After posting a quick how-to about Ruby-LDAP , I received a couple of very helpful comments that pointed me towards ruby-net-ldap . This is ...
It seems that the tools I take for granted are not used by all. This is the first in a series of posts where I will be sharing some of ...