Skip to content

docs(ref): Deprecate 'workspace.package.authors'#16951

Open
sivizius wants to merge 1 commit into
rust-lang:masterfrom
sivizius:deprecate-workspace-authors
Open

docs(ref): Deprecate 'workspace.package.authors'#16951
sivizius wants to merge 1 commit into
rust-lang:masterfrom
sivizius:deprecate-workspace-authors

Conversation

@sivizius
Copy link
Copy Markdown

@sivizius sivizius commented Apr 30, 2026

What does this PR try to resolve?

In #15068, package.authors was deprecated. There isn’t really a point in supporting workspace.package.authors which is used as authors.workspace = true, which was deprecated by the aforementioned PR. Various third-party tools, e.g. https://www.schemastore.org/cargo.json, already consider the workspace field as deprecated as well.

r? @ehuss @epage

@rustbot rustbot added A-documenting-cargo-itself Area: Cargo's documentation S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. labels Apr 30, 2026
@rustbot
Copy link
Copy Markdown
Collaborator

rustbot commented Apr 30, 2026

r? @ehuss

rustbot has assigned @ehuss.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

Why was this reviewer chosen?

The reviewer was selected based on:

  • Owners of files modified in this PR: @ehuss, @epage, @weihanglo
  • @ehuss, @epage, @weihanglo expanded to ehuss, epage, weihanglo
  • Random selection from ehuss, epage, weihanglo

Signed-off-by: Sebastian Walz <sebastian.walz@secunet.com>
@sivizius sivizius force-pushed the deprecate-workspace-authors branch from 68ee44e to 93eee6e Compare April 30, 2026 19:47
- Commands run in the workspace root will run against all workspace
members by default, see [`default-members`](#the-default-members-field).

## The `members` and `exclude` fields
Copy link
Copy Markdown
Author

@sivizius sivizius Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess, my editor automatically removed leading whitespace?

View changes since the review

* [`name`](#the-name-field) --- The name of the package.
* [`version`](#the-version-field) --- The version of the package.
* [`authors`](#the-authors-field) --- The authors of the package.
* [`authors`](#the-authors-field) --- The authors of the package (deprecated).
Copy link
Copy Markdown
Author

@sivizius sivizius Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically unrelated to this PR, but IMHO an annotation here similar to the replace below (line 55ish) is useful so one doesn’t need to scroll down to see the warning.

View changes since the review


[workspace.package]
version = "1.2.3"
authors = ["Nice Folks"]
Copy link
Copy Markdown
Author

@sivizius sivizius Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If it’s deprecated, there is no point in including it in an example.

View changes since the review

Comment thread src/doc/src/CHANGELOG.md
Copy link
Copy Markdown
Author

@sivizius sivizius Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for those changes, my editor removed trailing whitespace…not sure if I should leave those or if it’s ok?

View changes since the review

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, all the unrelated whitespace changes should not be included.

@rustbot rustbot assigned epage and ehuss and unassigned ehuss and epage Apr 30, 2026
Comment on lines +192 to +193
> **Warning**: The `authors` field is deprecated

Copy link
Copy Markdown
Contributor

@ehuss ehuss May 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think given that this is emphasized in many places (in particular the definition of the authors field itself) that this extra warning probably isn't necessary here.

View changes since the review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-documenting-cargo-itself Area: Cargo's documentation S-waiting-on-review Status: Awaiting review from the assignee but also interested parties.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants