On 09/10/2015 10:08 AM, Gael Varoquaux wrote: >> >And your statement "they are for advanced users" is not manifested in >> >the API or documentation. > OK, but that's a bug of the documentation. So you suggest adding to the docstring of every function "this is for advanced users only"? That is kind of like making them private, only that private is much more explicit. >> >There is no reason a user would expect one to act different from the other. > Users who don't code aglorithms probably don't have any reason to be > using them. > Well the reason would be they find them in the API docs and they don't know whether to use the class or the function.
It is fair to summarize your opinion as "functions don't need input validation or a consistent interface, the documentation should make clear they are for advanced users"? FWIW many of the functions do input validation at the moment, it is just inconsistent. ------------------------------------------------------------------------------ Monitor Your Dynamic Infrastructure at Any Scale With Datadog! Get real-time metrics from all of your servers, apps and tools in one place. SourceForge users - Click here to start your Free Trial of Datadog now! http://pubads.g.doubleclick.net/gampad/clk?id=241902991&iu=/4140 _______________________________________________ Scikit-learn-general mailing list Scikit-learn-general@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/scikit-learn-general
