tweaks to make the documentation more suitable for third parties