Add a [lints] entry for workspace members missing it (#11900)

# Objective

- Some workspace members do not inherit the global lints.

## Solution

- Add a `[lints]` entry for all files returned by `rg
--files-without-match -F "[lints]" **/Cargo.toml`, except the compile
failure tests since these aren't part of the workspace.
- Add some docstrings where needed.

---------

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>

crates/bevy_gizmos/macros/Cargo.toml

@@ -11,6 +11,9 @@ keywords = ["bevy"]
 [lib]
 proc-macro = true
 
+[lints]
+workspace = true
+
 [dependencies]
 bevy_macro_utils = { path = "../../bevy_macro_utils", version = "0.13.0" }
 

crates/bevy_gizmos/macros/src/lib.rs

@@ -1,8 +1,11 @@
+//! Derive implementations for `bevy_gizmos`.
+
 use bevy_macro_utils::BevyManifest;
 use proc_macro::TokenStream;
 use quote::quote;
 use syn::{parse_macro_input, parse_quote, DeriveInput, Path};
 
+/// Implements the [`GizmoConfigGroup`] trait for a gizmo config group type.
 #[proc_macro_derive(GizmoConfigGroup)]
 pub fn derive_gizmo_config_group(input: TokenStream) -> TokenStream {
     let mut ast = parse_macro_input!(input as DeriveInput);

errors/Cargo.toml

@@ -6,5 +6,8 @@ description = "Bevy's error codes"
 publish = false
 license = "MIT OR Apache-2.0"
 
+[lints]
+workspace = true
+
 [dependencies]
 bevy = { path = ".." }

errors/src/lib.rs

@@ -1,3 +1,7 @@
+//! Definitions of Bevy's error codes that might occur at runtime.
+//!
+//! These either manifest as a warning or a panic.
+
 #[doc = include_str!("../B0001.md")]
 pub struct B0001;
 

tools/build-templated-pages/Cargo.toml

@@ -6,6 +6,9 @@ description = "handle templated pages in Bevy repository"
 publish = false
 license = "MIT OR Apache-2.0"
 
+[lints]
+workspace = true
+
 [dependencies]
 toml_edit = { version = "0.22", default-features = false, features = ["parse"] }
 tera = "1.15"

tools/build-templated-pages/src/main.rs

@@ -1,3 +1,5 @@
+//! Tool used to build the templated pages of the Bevy website.
+
 use bitflags::bitflags;
 
 mod examples;

tools/build-wasm-example/Cargo.toml

@@ -5,7 +5,9 @@ edition = "2021"
 description = "Build an example for wasm"
 publish = false
 license = "MIT OR Apache-2.0"
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[lints]
+workspace = true
 
 [dependencies]
 xshell = "0.2"

tools/build-wasm-example/src/main.rs

@@ -1,3 +1,5 @@
+//! Tool used to build Bevy examples for wasm.
+
 use std::{fs::File, io::Write};
 
 use clap::{Parser, ValueEnum};

tools/ci/Cargo.toml

@@ -6,6 +6,9 @@ description = "CI script for Bevy"
 publish = false
 license = "MIT OR Apache-2.0"
 
+[lints]
+workspace = true
+
 [dependencies]
 xshell = "0.2"
 bitflags = "2.3"

tools/ci/src/main.rs

@@ -1,3 +1,5 @@
+//! CI script used for Bevy.
+
 use xshell::{cmd, Shell};
 
 use bitflags::bitflags;

tools/example-showcase/Cargo.toml

@@ -6,6 +6,9 @@ description = "Run examples"
 publish = false
 license = "MIT OR Apache-2.0"
 
+[lints]
+workspace = true
+
 [dependencies]
 xshell = "0.2"
 clap = { version = "4.0", features = ["derive"] }

tools/example-showcase/src/main.rs

@@ -1,3 +1,5 @@
+//! Tool to run all examples or generate a showcase page for the Bevy website.
+
 use std::{
     collections::{hash_map::DefaultHasher, HashMap},
     fmt::Display,