doc: improved effect section