Docs for kwargs in shift function

Issue Description

The docs for the shift function could be clearer. While the examples give you a rough idea what kwargs are accepted it would be nice with a complete list of accepted kwargs without poking through the code too much.