DOC: fix doc build warnings

This should fix all doc build errors/warnings (apart from the known ones).