Browse Source

feat(docs): Add docs about dependency pinning and upgrading

Signed-off-by: jld3103 <jld3103yt@gmail.com>
pull/937/head
jld3103 1 year ago
parent
commit
28bfc802fc
No known key found for this signature in database
GPG Key ID: 9062417B9E8EB7B3
  1. 3
      docs/README.md
  2. 7
      docs/dependencies.md

3
docs/README.md

@ -23,3 +23,6 @@ Check out our little [overview](architecture.md) of how the Neon project is buil
## [Neon workflows](workflows.md) ## [Neon workflows](workflows.md)
We have documented various workflows for working with the mono repo structure like adding a new package. We have documented various workflows for working with the mono repo structure like adding a new package.
## [Dependencies](dependencies.md)
How we pin and upgrade our dependencies

7
docs/dependencies.md

@ -0,0 +1,7 @@
# Dependencies
We follow the guidelines outlined in https://dart.dev/tools/pub/dependencies with some rules and automatic workflows:
1. We use the caret notation with the major version set to the latest major version and the minor and patch versions set to `0`. The constraint will be updated in case we need a particular feature or bug fix that was released in a newer version.
2. Dev dependencies should be pinned to the latest versions since they do not affect consumers of our packages.
3. Using Renovate we automatically update our dependency constraints. For non-dev dependencies this will be the latest major version, for everything else it will upgrade to the latest minor and patch versions as well. The lock files are also kept up-to-date with Renovate to compile everything with the latest available versions.
4. The same rules and automatic workflows apply to the Dart and Flutter versions we use.
Loading…
Cancel
Save