Docs build/deploy improvements

issues: closes #1608