Minor improvements to documentation. (#2846)
diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel
index ef6b2a4..5f22c97 100644
--- a/docs/BUILD.bazel
+++ b/docs/BUILD.bazel
@@ -48,7 +48,7 @@
],
),
page(
- name = "defs",
+ name = "rust",
symbols = [
"rust_binary",
"rust_library",
diff --git a/docs/book.toml b/docs/book.toml
index f8efa70..f91bc68 100644
--- a/docs/book.toml
+++ b/docs/book.toml
@@ -1,6 +1,9 @@
[book]
-authors = ["UebelAndre"]
+authors = ["UebelAndre", "illicitonion", "scentini"]
language = "en"
multilingual = false
src = "src"
title = "rules_rust"
+
+[output.html]
+git-repository-url = "https://github.com/bazelbuild/rules_rust"
diff --git a/docs/rust_analyzer.vm b/docs/rust_analyzer.vm
index 28ec97c..823afa1 100644
--- a/docs/rust_analyzer.vm
+++ b/docs/rust_analyzer.vm
@@ -54,7 +54,10 @@
{
"label": "Generate rust-project.json",
"command": "bazel",
- "args": ["run", "@rules_rust//tools/rust_analyzer:gen_rust_project"],
+ "args": [
+ "run",
+ "//tools/rust_analyzer:gen_rust_project"
+ ],
"options": {
"cwd": "${workspaceFolder}"
},
diff --git a/docs/rust_wasm_bindgen.vm b/docs/rust_wasm_bindgen.vm
index bee3825..7eedd7a 100644
--- a/docs/rust_wasm_bindgen.vm
+++ b/docs/rust_wasm_bindgen.vm
@@ -8,7 +8,7 @@
To begin using the `wasm-bindgen` rules, users can load the necessary dependencies
in their workspace by adding the following to their `WORKSPACE.bazel` file.
-```starlark
+```python
load("@rules_rust//wasm_bindgen:repositories.bzl", "rust_wasm_bindgen_dependencies", "rust_wasm_bindgen_register_toolchains")
rust_wasm_bindgen_dependencies()
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 5223362..60a5691 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -5,7 +5,7 @@
---
- [Rules](./rules.md)
- - [defs](./defs.md)
+ - [rust](./rust.md)
- [rustdoc](./rust_doc.md)
- [clippy](./rust_clippy.md)
- [rustfmt](./rust_fmt.md)
diff --git a/docs/src/index.md b/docs/src/index.md
index cf4d418..1045dca 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -1,6 +1,4 @@
-# [Rules Rust](https://github.com/bazelbuild/rules_rust)
-
-## Overview
+# Rules Rust
This repository provides rules for building [Rust][rust] projects with [Bazel][bazel].
diff --git a/docs/src/rules.md b/docs/src/rules.md
index 52a1f7f..40abdd8 100644
--- a/docs/src/rules.md
+++ b/docs/src/rules.md
@@ -1,18 +1,22 @@
# Rules
- [defs](defs.md): standard rust rules for building and testing libraries and binaries.
-- [rust_doc](rust_doc.md): rules for generating and testing rust documentation.
-- [rust_clippy](rust_clippy.md): rules for running [clippy](https://github.com/rust-lang/rust-clippy#readme).
-- [rust_fmt](rust_fmt.md): rules for running [rustfmt](https://github.com/rust-lang/rustfmt#readme).
-- [rust_proto](rust_proto.md): rules for generating [protobuf](https://developers.google.com/protocol-buffers) and [gRPC](https://grpc.io) stubs.
-- [rust_bindgen](rust_bindgen.md): rules for generating C++ bindings.
-- [rust_wasm_bindgen](rust_wasm_bindgen.md): rules for generating [WebAssembly](https://www.rust-lang.org/what/wasm) bindings.
+- [rustdoc](rust_doc.md): rules for generating and testing rust documentation.
+- [clippy](rust_clippy.md): rules for running [clippy](https://github.com/rust-lang/rust-clippy#readme).
+- [rustfmt](rust_fmt.md): rules for running [rustfmt](https://github.com/rust-lang/rustfmt#readme).
- [cargo](cargo.md): Rules dedicated to Cargo compatibility. ie: [`build.rs` scripts](https://doc.rust-lang.org/cargo/reference/build-scripts.html).
-- [crate_universe (bzlmod)](crate_universe_bzlmod.md): Rules for generating Bazel targets for external crate dependencies when using bzlmod.
-- [crate_universe (WORKSPACE)](crate_universe.md): Rules for generating Bazel targets for external crate dependencies when using WORKSPACE files.
-
-You can also browse the [full API in one page](flatten.md).
+- [crate_universe](external_crates.md): Rules for generating Bazel targets for external crate dependencies.
## Experimental rules
- [rust_analyzer](rust_analyzer.md): rules for generating `rust-project.json` files for [rust-analyzer](https://rust-analyzer.github.io/)
+
+## 3rd party rules
+
+- [rust_bindgen](rust_bindgen.md): rules for generating C++ bindings.
+- [rust_proto](rust_proto.md): rules for generating [protobuf](https://developers.google.com/protocol-buffers) and [gRPC](https://grpc.io) stubs.
+- [rust_wasm_bindgen](rust_wasm_bindgen.md): rules for generating [WebAssembly](https://www.rust-lang.org/what/wasm) bindings.
+
+## Full API
+
+You can also browse the [full API in one page](flatten.md).
diff --git a/docs/src/defs.md b/docs/src/rust.md
similarity index 99%
rename from docs/src/defs.md
rename to docs/src/rust.md
index 89d8f15..a8d0cc2 100644
--- a/docs/src/defs.md
+++ b/docs/src/rust.md
@@ -1,5 +1,5 @@
<!-- Generated with Stardoc: http://skydoc.bazel.build -->
-# Defs
+# Rust
* [rust_binary](#rust_binary)
* [rust_library](#rust_library)
diff --git a/docs/src/rust_analyzer.md b/docs/src/rust_analyzer.md
index 208ca6e..56d8fc0 100644
--- a/docs/src/rust_analyzer.md
+++ b/docs/src/rust_analyzer.md
@@ -60,7 +60,10 @@
{
"label": "Generate rust-project.json",
"command": "bazel",
- "args": ["run", "@rules_rust//tools/rust_analyzer:gen_rust_project"],
+ "args": [
+ "run",
+ "//tools/rust_analyzer:gen_rust_project"
+ ],
"options": {
"cwd": "${workspaceFolder}"
},
diff --git a/docs/src/rust_wasm_bindgen.md b/docs/src/rust_wasm_bindgen.md
index 98ed734..cb83723 100644
--- a/docs/src/rust_wasm_bindgen.md
+++ b/docs/src/rust_wasm_bindgen.md
@@ -17,7 +17,7 @@
To begin using the `wasm-bindgen` rules, users can load the necessary dependencies
in their workspace by adding the following to their `WORKSPACE.bazel` file.
-```starlark
+```python
load("@rules_rust//wasm_bindgen:repositories.bzl", "rust_wasm_bindgen_dependencies", "rust_wasm_bindgen_register_toolchains")
rust_wasm_bindgen_dependencies()
