Jacopo Cappellato wrote: > On Jan 28, 2010, at 4:43 PM, Adrian Crum wrote: > >> jaco...@apache.org wrote: >>> Author: jacopoc >>> Date: Thu Jan 28 06:53:11 2010 >>> New Revision: 903975 >>> URL: http://svn.apache.org/viewvc?rev=903975&view=rev >>> Log: >>> New blog entry about OFBiz Widgets from HotWax Media blog. >> That is an excellent tutorial! I wish we had more like that. >> >> One suggestion though: it might help newcomers to introduce them to the >> concept of expressions - since they are used so much in the project. So, >> instead of saying "uses the ${...} notation" maybe say something like "uses >> the expression ${...}" and then maybe have a link somewhere that takes them >> to a page that explains expressions in more detail. >> >> -Adrian > > Thank you Adrian, I appreciate your comments and suggestions. > You are right about the expression, when I write a post I always try to > imagine what kind of information a person new to OFBiz would like to read, > but it is difficult and, like it happened here, I sometimes miss my target... > this makes me think that one of the next posts could be a tutorial on > expressions :-)
I've found that experts have a very hard time writing documentation for newbies. They have been involved with whatever for so long, and know their target so well, it's almost instinct to them. It's very hard for experts to think like newbies. What may be obvious to the expert, will not be for someone new, so the expert would not think to include the explanation for the obvious part.
