site-www icon indicating copy to clipboard operation
site-www copied to clipboard

Published 20 hours ago • verified publisher icon dart-lang

Add page for advanced language features

Open kwalrath opened this issue 7 years ago • 2 comments

The language tour can't and shouldn't cover everything. We need another page to list less frequently used features, and to point to where people can find more information.

See discussion at dart-lang/sdk#33165.

kwalrath avatar Jun 14 '18 18:06 kwalrath

Actually, I think that it would help to have the language spec be accessible online in a format that it can be referenced. It should be versioned, just like the API docs site is. WDYT?

chalin avatar Jun 14 '18 19:06 chalin

Having the language spec be more available would be great, but it's aimed at implementers, not users. I personally consult the spec to find out how to talk about a language feature, not (usually) how to use it.

kwalrath avatar Jun 14 '18 22:06 kwalrath

Sounds like we're going to go the way of splitting up the language tour more (see https://github.com/dart-lang/site-www/issues/4565), so discussing advanced features will be easier, being a natural part of the sidebar or new sections on a page as needed.

I'm going to close this in favor of that work. If anyone has a specific advanced language feature that they would like to be documented, please open an issue specific to that feature. Thanks!

parlough avatar Feb 01 '23 05:02 parlough