You can't put comments in package.json, JSON should never have been used for something maintained by humans.
Re:I Like Makefiles
by ReleaseCandidat on Saturday September 21, 2024 @02:16AM
(#41607891)
We are not arguing whether not declaring phony targets is worse than using comments in `package.json`?
But anyway, comments in a Makefile or `package.json` are not documentation anyway, that's what the `README` or `INSTALL` (or whatever) is there for (in projects like the one the Makefile is written for).
I'd say putting the Makefile content in `package.json` would be more consistent, especially as they are already using Gulp as the build system.