doc: Package name: hello_world or hello-world ?

[behnam]

Problem
In https://doc.rust-lang.org/cargo/reference/manifest.html, we have:

name = "hello_world" # the name of the package

The same on master: https://github.com/rust-lang/cargo/blob/master/src/doc/src/reference/manifest.md#L12

But the common package name pattern (on crates.io and rest of the community) is to use hyphen-minus, like hello-world, and not underscore (hello_world).

Possible Solution(s)

Assuming that it's not intentional to use underscore (for some system compatibility reason), I think it's better to rename that like to use hyphen-minus.

What do you think?

[dwijnand]

But the common package name pattern (on crates.io and rest of the community) is to use hyphen-minus, like hello-world, and not underscore (hello_world).

I don't have pure data, but a casual glance at the front page of https://crates.io/ today actually shows more underscore usage than hyphen-minus (a few crates related to swc_ecma_parser released).

Anyways this changed in #522 and this issue seems duplicate of rust-lang/book#1709. But also here's a few more hyphen-minus vs underscore issues:

• Cargo should warn when creating a new project with a hyphen #380
• Accept hyphen in crate name in place of underscore #2775
• Underscores in names of the targets and crates #3085
• Hint at package name with dash/underscore mismatch #3925

[dwijnand]

Closing as in ok status quo, as explained in rust-lang/book#1709, with a better future tracked in #2775.