Skip to content

Commit d705cc2

Browse files
authored
Upgrade vitepress and improve wording in docs (#249)
1 parent 50d9c08 commit d705cc2

36 files changed

+823
-971
lines changed

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -214,11 +214,11 @@ See [alternatives](https://bon-rs.com/guide/alternatives) for comparison.
214214

215215
Some notable users:
216216

217-
- [`crates.io` backend](https://github.com/rust-lang/crates.io)
218-
- [`ractor`](https://github.com/slawlor/ractor)
219-
- [`comrak`](https://github.com/kivikakk/comrak)
220-
- [`soldeer`](https://github.com/mario-eth/soldeer) (package manager endorsed by [`foundry`](https://github.com/foundry-rs/foundry))
221-
- [`tachyonfx`](https://github.com/junkdog/tachyonfx)
217+
- [`crates.io` backend](https://github.com/rust-lang/crates.io)
218+
- [`ractor`](https://github.com/slawlor/ractor)
219+
- [`comrak`](https://github.com/kivikakk/comrak)
220+
- [`soldeer`](https://github.com/mario-eth/soldeer) (package manager endorsed by [`foundry`](https://github.com/foundry-rs/foundry))
221+
- [`tachyonfx`](https://github.com/junkdog/tachyonfx)
222222

223223
## Getting Help
224224

benchmarks/compilation/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ This is a collection of compilation time benchmarks for the code generated by `b
66

77
If you'd like to run the benchmarks yourself, first you need to install the following:
88

9-
- [`hyperfine`](https://github.com/sharkdp/hyperfine) CLI
9+
- [`hyperfine`](https://github.com/sharkdp/hyperfine) CLI
1010

1111
If you are on Linux, just run the following commands to install the dependencies:
1212

benchmarks/runtime/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ This is a collection of runtime benchmarks for the code generated by `bon` crate
66

77
If you'd like to run the benchmarks yourself, first you need to install the following:
88

9-
- `Valgrind`. Its `cachegrind` component is used by [`iai`](https://github.com/bheisler/iai) benchmark to display the instruction counts and cache/RAM hits.
10-
- `cargo-asm`. It's used to get the resulting assembly code for the benchmarked functions.
9+
- `Valgrind`. Its `cachegrind` component is used by [`iai`](https://github.com/bheisler/iai) benchmark to display the instruction counts and cache/RAM hits.
10+
- `cargo-asm`. It's used to get the resulting assembly code for the benchmarked functions.
1111

1212
If you are on Ubuntu or Debian, just run the following commands to install the dependencies:
1313

package-lock.json

Lines changed: 4 additions & 4 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"devDependencies": {
3-
"prettier": "^3.3.3"
3+
"prettier": "^3.5.3"
44
}
55
}

website/infra/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ It is a simple Hetzner VPS that runs a docker-compose cluster with the umami ser
88

99
Prerequisites:
1010

11-
- [Terraform CLI](https://developer.hashicorp.com/terraform/install)
12-
- [Account at hetzner.com/cloud](https://hetzner.com/cloud)
11+
- [Terraform CLI](https://developer.hashicorp.com/terraform/install)
12+
- [Account at hetzner.com/cloud](https://hetzner.com/cloud)
1313

1414
Create a `terraform.tfvars` file in this directory. Here is an example below, make sure to replace all `{...}` placeholders with your values.
1515

website/package-lock.json

Lines changed: 521 additions & 664 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

website/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
"medium-zoom": "^1.1.0",
2020
"ts-node": "^10.9.2",
2121
"ts-pattern": "^5.5.0",
22-
"vitepress": "^1.5.0"
22+
"vitepress": "^1.6.3"
2323
},
2424
"dependencies": {
2525
"vue": "^3.5.12"

website/src/blog/bon-builder-generator-v2-release.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -60,9 +60,9 @@ Now the documentation was split into the ["Guide"](../guide/overview) and ["Refe
6060

6161
We added 3 new pages with guides on how to use builders idiomatically or solve some common problems (e.g. validating inputs):
6262

63-
- [Conditional Building](../guide/patterns/conditional-building)
64-
- [Fallible Builders](../guide/patterns/fallible-builders)
65-
- [Into Conversions In-Depth](../guide/patterns/into-conversions-in-depth)
63+
- [Conditional Building](../guide/patterns/conditional-building)
64+
- [Fallible Builders](../guide/patterns/fallible-builders)
65+
- [Into Conversions In-Depth](../guide/patterns/into-conversions-in-depth)
6666

6767
I recommend you to check out the ["Into Conversions In-Depth"](../guide/patterns/into-conversions-in-depth) especially because it's highly related to one of the breaking changes that we'll review below.
6868

@@ -222,8 +222,8 @@ Also, huge thank you for 500 stars ⭐ [on Github](https://github.com/elastio/bo
222222

223223
You can leave comments for this post on the platform of your choice:
224224

225-
- [Reddit](https://www.reddit.com/r/rust/comments/1f1uzkw/bon_builder_generator_20_release/)
226-
- [X (Twitter)](https://x.com/veetaha/status/1828210142514491658)
227-
- [Hacker News](https://news.ycombinator.com/item?id=41359892)
225+
- [Reddit](https://www.reddit.com/r/rust/comments/1f1uzkw/bon_builder_generator_20_release/)
226+
- [X (Twitter)](https://x.com/veetaha/status/1828210142514491658)
227+
- [Hacker News](https://news.ycombinator.com/item?id=41359892)
228228

229229
:::

website/src/blog/bon-builder-v2-1-release.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,8 @@ This optimization covers only the code produced by expanding the [`#[bon::builde
2929

3030
The `#[builder]` macro now [benefits](https://github.com/elastio/bon/blob/88529337e261e8ca11268b2d4759f9372d802e45/bon/src/private/mod.rs#L8-L32) from the [`#[diagnostic::on_unimplemented]`](https://doc.rust-lang.org/nightly/reference/attributes/diagnostics.html#the-diagnosticon_unimplemented-attribute) attribute. It now generates a readable compile error with additional context for debugging in the following cases:
3131

32-
- Forgetting to set a required member.
33-
- Setting the same member twice (unintentional overwrite).
32+
- Forgetting to set a required member.
33+
- Setting the same member twice (unintentional overwrite).
3434

3535
Let's see this in action in the following example of code:
3636

@@ -249,8 +249,8 @@ Also, a huge thank you for 600 stars ⭐ [on Github](https://github.com/elastio/
249249

250250
You can leave comments for this post on the platform of your choice:
251251

252-
- [Reddit](https://www.reddit.com/r/rust/comments/1f6d7vr/media_nextgen_builder_macro_bon_21_release/)
253-
- [X (Twitter)](https://x.com/veetaha/status/1830221731677839637)
252+
- [Reddit](https://www.reddit.com/r/rust/comments/1f6d7vr/media_nextgen_builder_macro_bon_21_release/)
253+
- [X (Twitter)](https://x.com/veetaha/status/1830221731677839637)
254254

255255
:::
256256

0 commit comments

Comments
 (0)