Some clarifications in the docs regarding warnings and optimisations