Restore warning-less sphinx build

[bryevdv]

This PR fixes all outstanding sphinx warnings, and also restores the -W passed to sphinx-build to enforce no-warnings.

@tcmetzger I had to get rid of the ** glob and make the html_sidebars config slightly more explicit. Unfortunately I don't think there is any way to avoid this, given the limitations of glob syntax. But there's only a handful of directories and our docs structure does not change often.

I also made some of the sphinxext extensions much more informative, e.g. by changing "<bokeh-prop>" to f"<bokeh-prop: {model_name}.{prop_name}>". I am not sure why it took me 10+ years to realize that was an option...

@mattpap I put in minimal docstrings for bokeh build and bokeh init command. I think these can/should be expanded but I don't intend to do that in this PR.

[mattpap]

Scanning through documentation CI job's logs, there are a few complaints, that perhaps should be addressed in separate PR(s):

locale_dir /home/runner/work/bokeh/bokeh/docs/bokeh/source/locales/en/LC_MESSAGES does not exist

(repeats multiple times)

BokehDeprecationWarning: 'tile_providers module' was deprecated in Bokeh 3.0.0 and will be removed, use 'add_tile directly' instead.

The default value for navigation_with_keys will change to False in the next release. If you wish to preserve the old behavior for your site, set navigation_with_keys=True in the html_theme_options dict in your conf.py file. Be aware that navigation_with_keys = True has negative accessibility implications: pydata/pydata-sphinx-theme#1492

The version switcher "https://docs.bokeh.org/switcher.json" file is malformed; at least one of the items is missing the "url" or "version" key

reading sources... [ 21%] docs/examples/interaction/js_callbacks/doc_js_events
WARNING:bokeh.embed.util:
You are generating standalone HTML/JS output, but trying to use real Python
callbacks (i.e. with on_change or on_event). This combination cannot work.

reading sources... [ 44%] docs/examples/plotting/theme_glyphs
ERROR:bokeh.core.validation.check:E-1001 (BAD_COLUMN_NAME): Glyph refers to nonexistent column name. This could either be due to a misspelling or typo, or due to an expected column being missing. : text_font='Helvetica' [no close matches] {renderer: GlyphRenderer(id='p32875', ...)}

And finally the well known:

The HTML pages are in build/html.
cp: cannot stat '../../src/bokeh/server/static': No such file or directory

[mosc9575]

Because the docs for Windows are working again I suggest to add the -W option to the make.bat-file, too.

bokeh/docs/bokeh/make.bat

Line 41 in f5e07a3

%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%\html

[bryevdv]

Some of those are from testing deprecated APIs, so they make sense to be there and will go away when the deprecated APIs go away (speaking of, I think we could drop the tile provider one at this point?) I'll try to look at the other in another PR.

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.