Hey Adrin.
Thanks for your input.
I had also thought about the first one. It might be a bit tricky to
maintain, but would be quite helpful.
I'm not entirely sure about the second. How much detail should there be
on an algorithm?
The math behind the variational inference in some of the Bayesian models
is pretty lengthy.
If you want to write down the objective, that seems feasible, but not
all models optimize
an objective. So it's a bit unclear to me what the scope of the docs
should be.
Cheers,
Andy
On 10/29/18 12:08 PM, Adrin wrote:
Related to docs, my 2 cents from the conversations I've had with
people who are either new to "data science" or new to python and
usually come from R:
- People really like simple examples. The doctests we've added seem
like a good start (at least the very few I've talked to have told me
they really like it). I guess having more use-case oriented easy to
find tutorials would really help new users. If I'm not mistaken, most
tutorials on scikit-learn's website focus on the features and models
available in the package, and not the use-case.
- In many cases, when people search for something, they end up on the
API page for a class or a method, which almost never include the main
formula they're implementing (easy examples are the linear models
which can be explain by a one liner formula). Even if the user clicks
on the user guide link, they don't necessarily find how exactly it's
done there. In some cases they'll need to go and read a reference
paper if they want to understand the method in detail, many (or some)
of which are not even open access articles.
I guess it shouldn't be too hard to figure some well-formulated
projects out of these ideas, and I care enough about documentation
that I can give a hand wherever you think I can be useful.
Cheers,
Adrin.
On Thu, 25 Oct 2018 at 18:47 Andreas Mueller <t3k...@gmail.com
<mailto:t3k...@gmail.com>> wrote:
Hey.
Are we interested in the Google Season of Docs?
https://docs.google.com/forms/d/e/1FAIpQLSf-njReSfmp5i2olgmsDzrFR0Ll0UB5LkCzrtyM5o9Yw0foPw/viewform
https://docs.google.com/presentation/d/1ABqCc5uAoQv9aqGCxmNqOJ9S_Tst-adNV3fcWQ2Quwc/edit#slide=id.g42b115f18c_0_0
It requires a mentor, which has been an issue in the past.
But it looks like the idea is to have professionals partner up with
projects, not students.
The other problem would of course be formulating a clearly defined
project.
I think we could probably use some restructuring, or more focused
tutorials.
Wdyt?
Andy
_______________________________________________
scikit-learn mailing list
scikit-learn@python.org <mailto:scikit-learn@python.org>
https://mail.python.org/mailman/listinfo/scikit-learn
_______________________________________________
scikit-learn mailing list
scikit-learn@python.org
https://mail.python.org/mailman/listinfo/scikit-learn
_______________________________________________
scikit-learn mailing list
scikit-learn@python.org
https://mail.python.org/mailman/listinfo/scikit-learn
