jubatus / website Goto Github PK

http://jubat.us/idl.html

In RHEL 6, oniguruma package is provided under rhel-6-server-optional-rpms repository, which is disabled by default. We need to document it.

https://gist.github.com/suma/6710797#comment-915962

Note: RHEL clones like CentOS, Scientific Linux, ... require no special actions as they provide oniguruma under the standard repository.

Currently FAQ page is only available in English and should be translated. http://jubat.us/ja/faq.html

We cannot click index!

Write current C++ style guide to web.

typoを発見しましたのでご報告させていただきます。
jubaclassfier --rpc-port=9181 --name=tutorialとなっていますが「jubaclassifier」ですね。
http://jubat.us/tutorial.html#setup-a-single-process-jubatus-server

http://twitter.com/#!/oxycaster/status/130884476204093440

Website explains parameter and shows example, but it value is differ from installed ${prefix}/share/jubatus/example/config json files.
Is it helpful to write default parameter value before version 0.4.0?

example:

• web http://jubat.us/en/api_regression.html
• example json https://github.com/jubatus/jubatus/blob/master/config/regression/pa.json

-Z, --zookeeper_timeout and -I, --interconnect_timeout was added in 0.4.5 .
(See: jubatus/jubatus#344)

But it is not written in the documentation.
http://jubat.us/en/commands.html#cmdoption-server-t

Update: 2013-07-24
Sorry, I wrote wrong description.

Page URL:
http://jubat.us/ja/tutorial/anomaly.html

There is a misspelled word "jubaanomary" which should be "jubaanomaly".

Jubatus (or at least "ngram") currently expects UTF-8 but is not documented.

https://github.com/jubatus/jubatus/blob/master/src/fv_converter/character_ngram.cpp#L29

http://people.csail.mit.edu/jrennie/20Newsgroups/ has moived to http://qwone.com/~jason/20Newsgroups/

https://github.com/jubatus/website/blame/c5d1205e0c10b8c9e62472a85ac9afea08529632/source/en/tutorial.rst#L10

Deleted files are not committed by publish.sh.
The old API reference page is still a top-hit by googling jubatus api recommender.

Currently, Lock-type is documented in following page.

• http://jubat.us/en/server.html#jenerator-the-code-generator

User may be understand the Lock-type of RPC methods that defined in IDL.
But, common RPC methods (save, load ..) are not defined in IDL. So, user can not know Lock-type easily (Other than to read source code *_impl.cpp).

How about adding Lock-type in Client API page?

http://jubat.us/ja/tutorial/graph_java.html#id1

CreateGraph.java
092 : if (nodeName == "station_name1") {
093 : station1 = nodeValue;
094 : } else if (nodeName == "station_name2") {
095 : station2 = nodeValue;
096 : }

'==' should be 'equals()'

like this: http://wiki.apache.org/hadoop/HowToContribute

In Recommender API Reference, we say

"nearest_neighbor:* Use an implementation of nearest_neighbor of which algorithm name is specified in * .

However the implementation requres nearest_neighbor_recommender: prefix.

To follow renames on jubatus/jubatus .
jubatus/jubatus#451

Explanations for jubaanomaly (LOF) and its results are incorrect.

Need to correct it and update the tutorial source code for all languages.

We need to write more project information in website about:

• Project goal
• Project owner, member, maintainer
• Project roadmap/milestone (current development status)
• OSS policy for contribution or inquiry, and openness of the dev-community

Recover method.rst which removed e76c51f and add more method's algorithm description.

• PA(PA, PA1, PA2): Passive Aggressive
  • Koby Crammer, Ofer Dekel, Shai Shalev-Shwartz and Yoram Singer, Online Passive-Aggressive Al- gorithms, Proceedings of the Sixteenth Annual Conference on Neural Information Processing Systems (NIPS), 2003.
  • Koby Crammer, Ofer Dekel, Joseph Keshet, Shai Shalev-Shwartz, Yoram Singer, Online Passive- Aggressive Algorithms. Journal of Machine Learning Research, 2006.
  • Koby Crammer and Yoram Singer. Ultraconservative online algorithms for multiclass problems. Journal of Machine Learning Research, 2003.
• CW: Confidence Weighted Learning
  • MarkDredze,KobyCrammerandFernandoPereira,Confidence-WeightedLinearClassification,Proceed- ings of the 25th International Conference on Machine Learning (ICML), 2008
  • Koby Crammer, Mark Dredze and Fernando Pereira, Exact Convex Confidence-Weighted Learning, Pro- ceedings of the Twenty Second Annual Conference on Neural Information Processing Systems (NIPS), 2008
  • KobyCrammer,MarkDredzeandAlexKulesza,Multi-ClassConfidenceWeightedAlgorithms,Empirical Methods in Natural Language Processing (EMNLP), 2009
• AROW: Adaptive Regularization of Weight vectors
  • Koby Crammer, Alex Kulesza and Mark Dredze, Adaptive Regularization Of Weight Vectors, Advances in Neural Information Processing Systems, 2009
• NHERD: Normal Herd
  • Koby Crammer and Daniel D. Lee, Learning via Gaussian Herding, Neural Information Processing Systems (NIPS), 2010.

In source/tutorial.rst,

git clone [email protected]:jubatus/jubatus.git

and

git clone [email protected]:jubatus/jubatus-python.git

should be replaced with read-only git-URIs as follows.

git://github.com/jubatus/jubatus.git
git://github.com/jubatus/jubatus-python-client.git

This changes allows users who are trying the tutorial and aren't the member of jubatus project to clone the repositories.

Current jubatus doesn't require msgpack-rpc enabled pficommon, so it can be eliminated.

$ ./waf configure
  -> ensure that pficommon is configured with msgpack-rpc support enbabled ("MessagePack RPC module: yes")

and can it be updated glog 0.2 to 0.3?

Translate changes made in f9b7329 to English.

We only need to write file name of shared object to load a plugin.

jubatus/jubatus#57
http://jubat.us/en/fv_convert.html

Lifecycle of znodes, etc. must be documented.

suffix is documented for num_rules, but it is wrong.

• http://jubat.us/en/fv_convert.html#num-rules
• http://jubat.us/ja/fv_convert.html#num-rules

Japanese document, http://jubat.us/ja/fv_convert.html#feature-exctraction-from-string shows /usr/local/lib/libmecab_splitter.so not libux_splitter in example.
And fix plugin path to /usr/local/lib/jubatus/plugin next (bug-fixed) release.

http://jubat.us/fv_convert.html
If you're busy, dispatch to anyone available.

Currently we have docs about the interface and how to use, but are still lacking in the architecture overview and how it works.

• Document is obsolete (word_splitter::split is now const).
• Currently, only word_splitter is documented. string_filter, num_feature, num_filter must be documented.

http://jubat.us/server.html

Eliminate Japanese

• Current jubatus_serv interface changed
• Current implementation does not use CRTP(which stands for Curiously Recurring Template Pattern).

http://jubat.us/en/server.html#server

Japanese version is partially translated. http://jubat.us/ja/overview.html

Operation of Install is documented.
But, operation of upgrade is not documented.

jubatus/jubatus#247 (comment)

http://jubat.us/plugin.html
If you're busy, dispatch to anyone available.

Many people fails to run the tutorial program by using example configuration file. Steps must be revised.

https://twitter.com/trinity_site/status/345487824738476032

Client API constructors are currently not documented.

#apt-ubuntu section does not mention the x86_64 specification, so that 32bit users can take it wrong that they can also use apt for installing Jubatus.

It should be clarified as in Github

In the next release, Jubats building requirements is Python 2.4 and later:
jubatus/jubatus#296

I wrote what Python version requires (and needs update web):

Is FAQ necessary to delete in the develop(next release)?

c.f., http://qiita.com/items/77fe15a8e0667e1e6180

URL:
http://jubat.us/ja/tutorial/anomaly_python.html

There are [import] statements in [anomaly.py] :
from anomaly import client
from anomaly import types

These [import] statements cause the following error:
ImportError: cannot import name client

When I changed the import statements to:
from jubatus.anomaly import client
from jubatus.anomaly import types

The ImportError was disappeared, and [anomaly.py] was rightly executed.

About this issue jubatus/jubatus#389

Separate namespace between languages to avoid confliction to references. (see also: #29)

I'll fix in this week.