Whilst JSON does not support comments, today I learnt that npm reserves the key "//" for you to add comments to the top level object in package.json: https://stackoverflow.com/a/14221781/509706