+1 for English as much as I like language variety. Otis
----- Original Message ---- > From: Grant Ingersoll <gsing...@apache.org> > To: java-dev@lucene.apache.org > Sent: Friday, June 19, 2009 7:33:05 PM > Subject: Re: javadoc language > > I think they should be in English. Keeping the Chinese would be fine as > well, > but seems kind of pointless given all the other javadocs are in English. > > > On Jun 19, 2009, at 12:49 PM, Robert Muir wrote: > > > While hunting down some strange behavior in SmartChineseAnalyzer, I > > noticed the javadocs are in Chinese. > > > > some of these do not reflect the method params, which makes it a > > little harder to work with. > > > > /** > > * 设计上是SentenceTokenizer的下一处理层。将SentenceTokenizer的句子读出, > > * 利用HHMMSegment主程序将句子分词,然后将分词结果返回。 > > * > > * @param in 句子的Token > > * @param smooth 平滑函数 > > * @param dataPath 装载核心字典与二叉字典的目录 > > * @see init() > > */ > > public WordTokenizer(TokenStream in, WordSegmenter wordSegmenter) { > > this.in = in; > > this.wordSegmenter = wordSegmenter; > > } > > > > So I wonder, should the javadocs be in Chinese, English, or both? > > > > If they are in chinese, then developers that only speak english might > > have a tough time. > > If they are in english, chinese users might have a tough time, but > > then again the rest of lucene javadoc is in english. > > If they are in both, maintaining the chinese javadocs will be > > difficult for developers that only speak english, and vice-versa. > > > > Thanks! > > > > --Robert Muir > > rcm...@gmail.com > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org > > For additional commands, e-mail: java-dev-h...@lucene.apache.org > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org > For additional commands, e-mail: java-dev-h...@lucene.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org For additional commands, e-mail: java-dev-h...@lucene.apache.org