Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove Bower, Grunt, and Gulp from primary docs #851

Open
JoshuaKGoldberg opened this issue Jan 27, 2025 · 2 comments
Open

Remove Bower, Grunt, and Gulp from primary docs #851

JoshuaKGoldberg opened this issue Jan 27, 2025 · 2 comments

Comments

@JoshuaKGoldberg
Copy link
Contributor

JoshuaKGoldberg commented Jan 27, 2025

Following #846: the site's homepage and other docs around builders and package managers were last redone back when the web ecosystem was very different. In particular, the following were still in common popular use:

  • Build systems: Grunt and Gulp
  • Package managers: Bower was still

Those are no longer the case. Most users don't want to know about them anymore.

Proposal: let's remove them from the primary docs, and instead mention their equivalents:

  • Build systems: I don't know what to replace them with... Just, nothing? npm scripts?
  • Package managers: npm, pnpm, and yarn

I think it would make sense to leave "older" docs around in some capacity. Some older projects still use those things. Gulp in particular I think is still supported and has some users who appreciate its streaming capacities.

@JoshuaKGoldberg JoshuaKGoldberg changed the title Remove Bower, Grunt, and Gulp from docs Remove Bower, Grunt, and Gulp from primary docs Jan 27, 2025
@eddiemonge
Copy link
Member

As yeoman is meant to be opinionated, adding modern day replacements would be welcome. Perhaps recommend vite as it seems to be the most popular currently.

Package managers are mostly similar in the exposed API and so anytime a command from one is recommended, the code block that shows the commands could have tabs for how to install using each of them.

@eddiemonge eddiemonge marked this as a duplicate of #416 Jan 27, 2025
@mshima
Copy link
Member

mshima commented Jan 27, 2025

I suppose the referred part is https://github.com/yeoman/yeoman.io/blob/main/app/index.html#L55-L76.

No build system is supported by yo. They are generator specific, we probably should mention build systems when mentioning generator-webapp only.

npm/yarn/pnp package managers are supported by generator/environments apis.
this.packageJson and related apis on generator side. package.json file modification check, auto install and package manager detection on the environment side.

My suggestion is to drop build system or move to a dedicated section mentioning generator-webapp.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: No status
Development

No branches or pull requests

3 participants