Skip to content

Conversation

@madsmtm
Copy link
Contributor

@madsmtm madsmtm commented Nov 23, 2025

  • "vector" is what "vec" is short form for.
  • "list" is a common name for this concept in a lot of other languages (ArrayList in Java, list in Python, List in C#). C++ uses the term for a linked list (std::list), so maybe this is contentious?

I believe that this falls under the doc alias policy, and I think it's plausible that a newcomer would search for either of these terms, and expect to find Vec.

r? libs

@madsmtm madsmtm added A-docs Area: Documentation for any part of the project, including the compiler, standard library, and tools T-libs Relevant to the library team, which will review and decide on the PR/issue. A-doc-alias Area: `#[doc(alias)]` labels Nov 23, 2025
@rustbot rustbot added the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label Nov 23, 2025
@Noratrieb
Copy link
Member

There must be an obvious single target for the alias that is an exact analogue of the aliased name

I think list doesn't quite match that part of the policy because of what you said, but Vec is an extremely important and common type while LinkedList is pretty much useless, so I think it makes a lot of sense to put it on vec. Anyone who's looking for linked lists just doesn't know that they're looking for vec yet :3.

@bors r+ rollup

@bors
Copy link
Collaborator

bors commented Nov 23, 2025

📌 Commit 1111730 has been approved by Noratrieb

It is now in the queue for this repository.

@bors bors added S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion. and removed S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. labels Nov 23, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-doc-alias Area: `#[doc(alias)]` A-docs Area: Documentation for any part of the project, including the compiler, standard library, and tools S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion. T-libs Relevant to the library team, which will review and decide on the PR/issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants