This [post from resin.io](https://resin.io/blog/open-source-guide-1-documentation-and-jsdoc/?utm_source=Resin+Users&utm_campaign=b4e575ed02-EMAIL_CAMPAIGN_2017_01_31&utm_medium=email&utm_term=0_1c73cb7379-b4e575ed02-202943545) seems to be a good starting point to improve it.