cxf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Freeman Fang <freeman.f...@gmail.com>
Subject Re: [PROPOSAL] Rename "Simple Frontend" --> "No-Annotation Frontend"?
Date Thu, 30 Aug 2012 23:45:56 GMT
+1 to update the docs.

Freeman
-------------
Freeman Fang

FuseSource
Email:ffang@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.


Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message