diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a291ca906..5e6df6f9e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -214,7 +214,7 @@ be viewed by clicking the `details` link on the ### Building Documentation Tracing's documentation uses nightly-only RustDoc features and lints, like -`doc(cfg)` and `broken_intra_doc_lints`. These features are enabled by +`doc(cfg)` and `broken_intra_doc_lints`. These features are enabled by passing `--cfg docsrs` to RustDoc. Therefore, in order to build Tracing's documentation the same way it would be built by docs.rs, it's necessary to use the following command: @@ -430,8 +430,7 @@ When releasing a new version of a crate, follow these steps: 2. **Update Cargo metadata.** After releasing any path dependencies, update the `version` field in `Cargo.toml` to the new version, and the `documentation` field to the docs.rs URL of the new version. -3. **Update other documentation links.** Update the `#![doc(html_root_url)]` - attribute in the crate's `lib.rs` and the "Documentation" link in the crate's +3. **Update the "Documentation" link in the crate's `README.md` to point to the docs.rs URL of the new version. 4. **Update the changelog for the crate.** Each crate in the Tokio repository has its own `CHANGELOG.md` in that crate's subdirectory. Any changes to that diff --git a/tracing-attributes/Cargo.toml b/tracing-attributes/Cargo.toml index 145464cd2..8ab13c062 100644 --- a/tracing-attributes/Cargo.toml +++ b/tracing-attributes/Cargo.toml @@ -2,10 +2,7 @@ name = "tracing-attributes" # When releasing to crates.io: # - Remove path dependencies -# - Update html_root_url. -# - Update doc url -# - Cargo.toml -# - README.md +# - Update doc url in README.md. # - Update CHANGELOG.md. # - Create "v0.2.x" git tag. version = "0.2.0" diff --git a/tracing-core/Cargo.toml b/tracing-core/Cargo.toml index 88ff413ea..ef9d36af1 100644 --- a/tracing-core/Cargo.toml +++ b/tracing-core/Cargo.toml @@ -3,9 +3,7 @@ name = "tracing-core" # When releasing to crates.io: # - Remove path dependencies # - Update html_root_url. -# - Update doc url -# - Cargo.toml -# - README.md +# - Update doc url in README.md. # - Update CHANGELOG.md. # - Create "v0.2.x" git tag. version = "0.2.0" diff --git a/tracing-error/Cargo.toml b/tracing-error/Cargo.toml index 10312ac29..4731081cd 100644 --- a/tracing-error/Cargo.toml +++ b/tracing-error/Cargo.toml @@ -2,10 +2,7 @@ name = "tracing-error" # When releasing to crates.io: # - Remove path dependencies -# - Update html_root_url. -# - Update doc url -# - Cargo.toml -# - README.md +# - Update doc url in README.md. # - Update CHANGELOG.md. # - Create "v0.2.x" git tag version = "0.2.0" diff --git a/tracing/Cargo.toml b/tracing/Cargo.toml index 4e4a51696..ede91b7ca 100644 --- a/tracing/Cargo.toml +++ b/tracing/Cargo.toml @@ -2,10 +2,7 @@ name = "tracing" # When releasing to crates.io: # - Remove path dependencies -# - Update html_root_url. -# - Update doc url -# - Cargo.toml -# - README.md +# - Update doc url in README.md. # - Update CHANGELOG.md. # - Create "v0.2.x" git tag version = "0.2.0"