update docs with offsets