npm Community Forum (Archive)

The npm community forum has been discontinued.

To discuss usage of npm, visit the GitHub Support Community.

Standardize a `changes` log property for pointing to CHANGES.md, HISTORY, etc.

Having a standard property in package.json for pointing to a project’s CHANGES/HISTORY file (probably most logically within directories) would assist the npmjs.com website and command line tools to be able to link to or pull up recent changes, respectively, e.g., after running the likes of npm-check-updates to see dependencies available for updating–noting changes, before applying any updates.


Yes, fits in with the “one day” plans for directories. :-)

I notice there is already some support for including such files in package with convention rather than configuration: https://docs.npmjs.com/files/package.json#files

Certain files are always included, regardless of settings:

  • CHANGES / CHANGELOG / HISTORY

README , CHANGES , LICENSE & NOTICE can have any case and extension.


Yes, I was thinking it would be nice to check some convention and check the existence of those derivatives of CHANGES as fallback (or perhaps false to hide the CHANGES). It might even allow pointing to a JS-based changes script, with optional version argument passed in, but if there is no JS extension or designated type, perhaps parsing the CHANGES file as Markdown and displaying the relevant queried version or version range, or, for HTML rendering, bringing it to the anchor.