Various fixes and improvements

Hi, Not sure if you still maintain this but thought I'd submit a PR anyway. Sorry for the "whole bunch of changes". This PR basically contains a bunch of fixes and improvements that I've done over the source of documenting our own NodeJS projects in house. Let me know what you think!