update docs & test unpacking into slices
expand docs