Hacker News new | ask | show | jobs
by dragonwriter 976 days ago
> Normally tutorials ask readers to install latest versions of everything.

They shouldn't.

They should be doing specified versions, either precise or bounded to the degree you trust the dependency suppliers semver compliance.

> If you have to provide a version for every package used in a tutorial, it means that every time any of such dependencies releases a new version the tutorial has to be updated.

No. It doesn't. You document what version is covered. You then have the choice to update that or not.

OTOH, failing to specify dependency versions means every time abmny of the dependencies releases a new version, the tutorial potentially breaks, which is much worse than working fine but not using a newer version of a dependency when you are not, in either case, using any new features of the new version. (Because if you aren’t upgrading the tutorial, its not covering features of the new version, even if the loosely-specified packages mean uses will pull in the new versions.)