Update best practice doc after taking in DanielR's advices