The "-t" flag of "dart create" remains undocumented, can we change it ?

[projektorius96]

Page URL

https://dart.dev/tools/pub/create-packages/

Page source

https://github.com/dart-lang/site-www/tree/main/src/content/tools/pub/create-packages.md

Describe the problem

Currently this page and especially CLI reference for dart create does not provide -t flag explanation: judging the context -t should stand for "-type" as in the following command example:

dart create -t package my_package_name 

Let's agree, at minimum the flag -t should be documented on Dart SDK's CLI reference page without excuses, rather than leaving it for Dart beginner developers to figure out themselves: every self-respecting dev would say, this thread (like many others) could be avoided from being issued, if the docs were a bit more explicit than it currently is...

Expected fix

Please be explicit in your documentation, thank you !

Additional context

I wish a legendary Steve Ballmer's "Developer Developers Developers" words were temporarily switched for "Documentation Documentation Documentation"...

I would like to fix this problem.

• I will try and fix this problem on dart.dev.

[IldySilva]

Good point , -t (or --template) is really useful, and I agree it should be easier to find.

It's actually documented here: https://dart.dev/tools/dart-create
But yeah, it’s not super obvious from other pages like the pub one, so it’s easy to miss.
Maybe worth improving the linking? cc @parlough , @antfitch

[parlough]

Thanks for opening an issue to discuss this and both of you for the discussion!

But yeah, it’s not super obvious from other pages like the pub one, so it’s easy to miss.
Maybe worth improving the linking?

Good point! I agree we shouldn't duplicate the documentation and can instead improve the dart create page and add a cross link to there.

What do you think about splitting https://dart.dev/tools/dart-create into a few sections with headers (including one about specifying a template and the template types). Then on https://dart.dev/tools/pub/create-packages after the dart create -t package <PACKAGE_NAME> code block, we could add some text that cross links to the other template types.

[IldySilva]

Thanks for opening an issue to discuss this and both of you for the discussion!

But yeah, it’s not super obvious from other pages like the pub one, so it’s easy to miss.
Maybe worth improving the linking?

Good point! I agree we shouldn't duplicate the documentation and can instead improve the dart create page and add a cross link to there.

What do you think about splitting https://dart.dev/tools/dart-create into a few sections with headers (including one about specifying a template and the template types). Then on https://dart.dev/tools/pub/create-packages after the dart create -t package <PACKAGE_NAME> code block, we could add some text that cross links to the other template types.

Sounds great.

[parlough]

Thanks for the discussion here! @IldySilva landed improvements to the primary dart create page and added cross links to there from Creating packages page in #6751. Thank you again @IldySilva and for @projektorius96 for reporting this :)