+1 to update the docs. Freeman －－－－－－－－－－－－－ Freeman Fang
FuseSource Email:ff...@fusesource.com Web: fusesource.com Twitter: freemanfang Blog: http://freemanfang.blogspot.com http://blog.sina.com.cn/u/1473905042 weibo: http://weibo.com/u/1473905042 On 2012-8-31, at 上午4:31, Glen Mazza wrote: > Team, I'd like to rename our Simple Front End > (https://cwiki.apache.org/confluence/display/CXF20DOC/Simple+Frontend) in > our Confluence docs. > > The problem with naming it "simple" is that it (1) falsely implies to > newcomers that JAX-WS is difficult and something nasty to be avoided, and > (2) its "simple" name encourages newcomers to use it. Further, what might > be simple for the first twenty minutes of development may not actually be > simple for the next six months of maintainance, and on that basis a fair > argument could be made that the JAX-WS frontend is really the "simple" one. > > Accordingly, I'd like to rename it the "No-Annotation Frontend" (I'm open to > other ideas), because that's precisely what it is while being neutral about > the other front end options (i.e., it's not good to have a frontend called > "the intelligent frontend" or "the well-designed frontend" as it just makes > the others look bad that way), and it also does not unduly encourage people > to use it over the default JAX-WS front end. > > This will just be a Confluence search and replace (only a few pages). I'll > keep the "simple"-named Schema as well as the -simple wsdl2java tooling > option (just explaining it's for the no-Annotation front end in the > docs)--while I *could* change those it would raise backward compatibility > headaches for what is increasingly a seldom-used front end, so I don't think > its worth the effort. > > WDYT? > > Glen > > > > -- > View this message in context: > http://cxf.547215.n5.nabble.com/PROPOSAL-Rename-Simple-Frontend-No-Annotation-Frontend-tp5713384.html > Sent from the cxf-dev mailing list archive at Nabble.com.
