docs improved

Related to https://github.com/yiisoft/yii2/pull/2159#issuecomment-33326400