Simplify webpack and codebase

[choldgraf]

The goal of this PR is to boost maintainability of this theme a little bit, it does a couple of things:

• Consolidates our webpack config into a single file rather than splitting between dev and prod
• Uses sphinx-autobuild in our nox -s docs-live environment to auto-gen the docs
• Removes two deprecated functions from our init.py
• Documents using nox without the virtual environment

Longer term, I would be a fan of simplifying our webpack story even further (potentially removing it entirely). While it is quite useful in the javascript world, I'd be a fan of removing our vendor dependencies in general and only including stuff that we really need by manually adding it into a stc/vendor folder so that it's easier to notice. I think we have to assume the average maintainer of this repository is not familiar with JS workflows, and our current developer tools are already pretty complex for somebody with this background.

closes #468

[jorisvandenbossche]

Basically this file is all development dependencies + all additional doc dependencies (required to build the docs)?
(my first reaction was: you don't need sphinx-autobuild to build the docs, but you neither need pytest for that, so the naming/location of the file is a bit confusing I suppose)

[choldgraf]

yep - maybe another approach would be to define dev dependencies in the install itself as an extras_require?

I'm also find just hard-coding sphinx-autobuild in the install for the relevant nox job.

[jorisvandenbossche]

yep - maybe another approach would be to define dev dependencies in the install itself as an extras_require?

The main problem (for my personal workflow) is that this doesn't work with conda .. (so for that I still prefer to have a file listing all those optionals/development deps)

Now, this is an existing issue. So merging here as is.

[jorisvandenbossche]

Looks good! Gave this a quick test drive locally, and seems to be working nicely (and better than what we currently have)

[jorisvandenbossche]

Longer term, I would be a fan of simplifying our webpack story even further (potentially removing it entirely). While it is quite useful in the javascript world, I'd be a fan of removing our vendor dependencies in general and only including stuff that we really need by manually adding it into a stc/vendor folder so that it's easier to notice. I think we have to assume the average maintainer of this repository is not familiar with JS workflows, and our current developer tools are already pretty complex for somebody with this background.

Sounds good to me. I suppose the build aspect of webpack can be replaced with https://github.com/executablebooks/web-compile?