You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/2025h1/cargo-plumbing.md
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Cargo should integrate.
15
15
## Motivation
16
16
17
17
Cargo is a "porcelain" (UX) focused command and is highly opinionated which can work well for common cases.
18
-
However, as Cargo scales into larger applications, users need to adapt to their specific processes and needs.
18
+
However, as Cargo scales into larger applications, users need the ability to adapt Cargo to their specific processes and needs.
19
19
20
20
### The status quo
21
21
@@ -80,7 +80,7 @@ Encapsulating stabilized file formats can serve as a starting point for output
80
80
schemas as we already output those and have to deal with stability guarantees
81
81
around these.
82
82
83
-
Between planning a build and executing abuild is likely to look like
83
+
Between planning a build and executing a build is likely to look like
84
84
`--unit-graph` and a plan will need to be put forward for how to work through
85
85
the open issues.
86
86
There will likely be similar issues for any other output that can't leverage existing formats.
@@ -99,12 +99,12 @@ Otherwise, performance should wait on user feedback.
99
99
100
100
A schema evolution plan will need to be considered with the design of the schema.
101
101
How Cargo deals with evolution of existing output could serve as potential starting points:
102
-
-`Cargo.toml` (generated by `cargo package`) should not still be readable by `cargo` versions within the specified `package.rust-version`
102
+
-`Cargo.toml` (generated by `cargo package`) should still be readable by `cargo` versions within the specified `package.rust-version`
103
103
- In the absence of a `package.rust-version`, `Cargo.toml` should only represent features the user explicitly used or optional features that were always allowed on stable `cargo`
104
-
-`Cargo.lock` (generated by most commands) is strictly versioned: all versions of Cargo should output should work in all other versions of Cargo for that given version and changing Cargo versions should not cause the output to change
104
+
-`Cargo.lock` (generated by most commands) is strictly versioned: all versions of Cargo should output a lockfile that works in all other versions of Cargo for that given version and changing Cargo versions should not cause the output to change
105
105
- Cargo bumps the default format version after it has been stabilized for a "sufficient period of time"
106
106
- The default is capped by what is supported by the lowest `package.rust-version` in the workspace
107
-
-`cargo metadata --format-version`: defaults to "latest" ywith a warning
107
+
-`cargo metadata --format-version`: defaults to "latest" with a warning
108
108
- We attempt to follow the same practice as `Cargo.toml`
109
109
-`--message-format`: no versioning currently
110
110
- We attempt to follow the same practice as `Cargo.toml`
0 commit comments