Installation documentation uses undocumented feature

[breyed]

The yarn install docs say to use the command yarn init -2. Wondering what the -2 meant, I checked out the docs for init. They don't say anything about the -2 switch. This is especially surprising for something so high profile as initial onboarding docs. Is something missing from or out of date in the documentation?

[arcanis]

It creates and configure the project using the modern versions of Yarn. Without that, for backward compatibility, the created project will use whatever is your global binary, which is likely outdated.

The flag should probably be listed in yarn init's documentation to clear up confusion, indeed.

[SamB]

Yes, it should probably be listed at one or both of https://yarnpkg.com/cli/init (because it's used by Yarn 2+ users) and https://classic.yarnpkg.com/en/docs/cli/init (because it's actually implemented as part of Yarn 1.x).