Skip to content

Commit aa6d38e

Browse files
authored
Merge pull request #211 from epage/fixes
fix(plumbing): Fix typos that obfuscate the intent
2 parents e0dc423 + 09c2337 commit aa6d38e

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

src/2025h1/cargo-plumbing.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Cargo should integrate.
1515
## Motivation
1616

1717
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.
1919

2020
### The status quo
2121

@@ -80,7 +80,7 @@ Encapsulating stabilized file formats can serve as a starting point for output
8080
schemas as we already output those and have to deal with stability guarantees
8181
around these.
8282

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
8484
`--unit-graph` and a plan will need to be put forward for how to work through
8585
the open issues.
8686
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.
9999

100100
A schema evolution plan will need to be considered with the design of the schema.
101101
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`
103103
- 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
105105
- Cargo bumps the default format version after it has been stabilized for a "sufficient period of time"
106106
- 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
108108
- We attempt to follow the same practice as `Cargo.toml`
109109
- `--message-format`: no versioning currently
110110
- We attempt to follow the same practice as `Cargo.toml`

0 commit comments

Comments
 (0)