|
[hidden email] 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 |
|
On Jan 28, 2010, at 4:43 PM, Adrian Crum wrote: > [hidden email] 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 :-) Jacopo |
|
Jacopo Cappellato wrote:
> On Jan 28, 2010, at 4:43 PM, Adrian Crum wrote: > >> [hidden email] 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. |
|
Administrator
|
From: "Adam Heath" <[hidden email]>
> Jacopo Cappellato wrote: >> On Jan 28, 2010, at 4:43 PM, Adrian Crum wrote: >> >>> [hidden email] 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. Obvious for him/her ;o) This is a large part of misunderstanding in our world, well spotted! Jacques |
| Free forum by Nabble | Edit this page |
