hosseinmd / prettier-plugin-jsdoc

A Prettier plugin to format JSDoc comments.
MIT License
232 stars 28 forks source link

fix: clean published files #140

Closed jaydenseric closed 2 years ago

jaydenseric commented 2 years ago
hosseinmd commented 2 years ago

Awesome could you add changelog to whitelist

hosseinmd commented 2 years ago

Is that good for SEO?

jaydenseric commented 2 years ago

It's desirable not to publish the changelog so that the install size of the package is stable and it doesn't keep growing limitlessly over time as new versions are added to the changelog. Changelogs can become quite big.

It's safe to not publish the changelog, as no-one reads the it from within node_modules. NPM no longer forces CHANGELOG.md to be published. NPM still forces README.md to be published, but I think that's because there is a chance that it contains the software license.

The changelog versioned in the GitHub repo is a better reference for users to read, as any corrections for past version changelog entries (updates to broken links, adding missing changes, etc.) can be seen whereas the changelogs published to npm are frozen in time and can't be amended.

Let me know if you are still sure you want to publish the changlog and I'll update this PR :)

Is that good for SEO?

Sorry, I'm not sure exactly what you're referring to as "that".

hosseinmd commented 2 years ago

Thank you.