Docs update

[jimmymathews]

• Adds a spatial metric example
• Deprecates old material and images
• Adds a TOC (the built-in one is not really conspicuous enough)