Full rewrite of Energy Coordination docs

[trulshj]

This is being kept as an artifact store, most changes here have been moved into other PRs