Breaking changes for next major release

[blaugold]

This issue is for collecting and discussing breaking changes for a future major release so that we can batch them and make it easier for users to migrate. We should create a migration guide when the time comes.

Features to remove

• --since filter option (feat!: remove --since filter in favour of --diff #454)
  • --diff (feat: Add --diff filter #323) does the same as --since but is more powerful. Having two options that have the same functionality can be confusing.

Options to enable per default

These options have been successively added and were not enabled by default to not break things. They are generally useful features that most users will want to have enabled.

• Enable includeScopes (feat: write conventional commit scopes in changelog #341).
• Enable linkToCommits (feat: add support for linking to commits in changelog #186), if repository is set.
• Enable workspaceChangelog (feat: optionally allow generating workspace root change logs #161).
• feat!: enable more options by default #457

Move to dependency_overrides.yaml and Dart 2.18.0

We should consider removing support for bootstrapping with temporary packages and fully move to pubspec_overrides.yaml.

This would require moving to Dart 2.18.0 as the minimum supported version to ensure that publishing with dependency_overrides.yaml works without a workaround.

The advantages are:

• Users won't run into the issues related to temporary packages and get the improved integration with other tools.
• We don't have to maintain two mechanisms for bootstrapping.
• Between 2.12.0 and 2.18.0 a number of useful language features were added.

To do

Tasks that need to be completed, if we decide to move to dependency_overrides.yaml.

• Remove usePubsecOverrides.
• Remove temporary packages bootstrapping mechanism.
• Update docs to explain:
  • how bootstrapping uses dependency_overrides.yaml files.
  • that dependency_overrides.yaml should be ignored.
  • how pub get works in a bootstrapped workspace.
  • when melos bootstrap needs to be rerun.
• Upgrade Dart version constraints.

Rework hooks

• request: add hook for version command, which runs after versioning but before committing #321.

Local installation of Melos

• feat!: local installation of melos in workspace #431

Rename config options to be consistent

• feat!: make naming around package filters more consistent #462

Fetch tags before versioning

• feat: fetch tags before versioning #461

[spydon]

Closing this since the release already occurred.