Made the doc string more descriptive.
Added some function annotations. - they don't have an effect no how the function is used though.