add missing docblock
add example for valueOrCallback()