clear some uncertainties with ready() doc