DOC : added docstring to init_artists + comments

 - added docstring
 - fixed up/removed misleading in-line comments