Verified entire docs. Added requested note. Waiting for green light from Massimiliano Ziccardi and we can merge this