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

Reply via email to