add some notes in the docstrings
add some notes in the docstrings

scikit-rf/scikit-rf,temmeand/scikit-rf,jhillairet/scikit-rf,temmeand/scikit-rf,jhillairet/scikit-rf,temmeand/scikit-rf,jhillairet/scikit-rf,scikit-rf/scikit-rf