[docs] Bring docs Makefile up to date with maccore and general cleanup

This brings the Makefile up to date with recent changes to maccore for building the docs.

Relates to https://github.com/mono/maccore/pull/55