Skeleton for a glossary of concepts and API elements.
This responds to at least three issues:
* Many aspects of scikit-learn API for users and developers are known
tacitly by core contributors (and the stack overflow crowd), but are
not written down in a consistent place.
* What is written is in an ad-hoc narrative style which may be useful
for introduction, but is difficult to refer to and to maintain.
* Parameters such as `n_jobs` and methods like `decision_function` are
described repeatedly in documentation giving sometimes more sometimes
less information. This glossary allows us to use "See :term:`the
glossary <n_jobs>`." so that parameter descriptions in the
API reference can remain brief (just as not every numpy operation
needs to describe broadcasting).
* DOC updated plot_stock_market.py to use Google Finance
The implementations is intentionally very basic not to distract the users
from the example. Specifically unlike ``quotes_historical_yahoo_ochl`` it
does not cache downloaded data.
I also had to remove some symbols because the have no data on Google for
the specified date interval. These are WBA, LMT, KFT and MTU.
Closes#8899
* DOC removed plot_stock_market.py from expected failing examples
* Addressed review comments
* Addressed another pass of review comments
Sphinx loads its extensions sequentially as they are specified on the
list. Sphinx-Gallery relies en autodoc to generated the example
thumbnails when auto documenting the API. If autodoc is not loaded
sphinx-gallery skips this step, as it implies the user might not want
it. In this case we need it, so the gallery has to be loaded after
autodoc and autosummary.
The autosummary_generate variable is repeated
master has 0.16-only commits since the 0.15-branching tag.
New features have to be documented as new features in the 0.16 section.
Bugfixes to be included in the 0.15.0 release have to be cherry-pick'ed in the
0.15.X branch and document in the 0.15 section.
Adrin Jalali
Hanmin Qin