Add a returns section to the docs on segwit::decode

[tcharding]

We return a 3 element tuple but do not document what it is or the guarntees on the vector length. Do so.