New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Initial attempt at combining tutorials and codelabs #4875
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@mit-mit : Love this suggestion. I added a few notes.
If you like learning via coding exercises | ||
checkout the [Dart koans](/codelabs/dart-cheatsheet). | ||
For a more textual introduction see the | ||
[language intro](/language). | ||
The Language menu on the left also has tutorials | ||
on more detailed topics, and tutorials written | ||
for those with existing knowledge of other programming languages. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
issue: Need to add commas to the dependent clauses.
If you like learning via coding exercises | |
checkout the [Dart koans](/codelabs/dart-cheatsheet). | |
For a more textual introduction see the | |
[language intro](/language). | |
The Language menu on the left also has tutorials | |
on more detailed topics, and tutorials written | |
for those with existing knowledge of other programming languages. | |
If you like learning via coding exercises, | |
check out the [Dart koans](/codelabs/dart-cheatsheet). | |
To get an in-depth explanation, see the | |
[language intro](/language). | |
The Language menu also includes tutorials on more | |
detailed topics and for those with existing knowledge | |
of other programming languages. |
The Libraries menu contains tutorials on the Dart core libraries, | ||
including collections, math, asynchronous programming, and I/O. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
issue: We don't need to describe the TOC. We can link to it.
The Libraries menu contains tutorials on the Dart core libraries, | |
including collections, math, asynchronous programming, and I/O. | |
Libraries contains tutorials on the Dart core libraries, | |
including collections, math, asynchronous programming, and I/O. |
This tutorial teaches you about Dart’s [null-safe type system](/null-safety), | ||
which was introduced in Dart 2.12. When you opt into null safety, | ||
types in your code are non-nullable by default, | ||
meaning that values can’t be `null` unless you say they can be. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
suggestion: Write as shorter sentences per GSG.
This tutorial teaches you about Dart’s [null-safe type system](/null-safety), | |
which was introduced in Dart 2.12. When you opt into null safety, | |
types in your code are non-nullable by default, | |
meaning that values can’t be `null` unless you say they can be. | |
This tutorial explains Dart’s [null-safe type system](/null-safety). | |
Dart 2.12 introduced null safety and Dart 3 made it the default setting. | |
With null safety, types in your code default to non-nullable. | |
This means that values can’t be `null` unless you say they can be. |
@@ -22,7 +22,7 @@ This codelab covers the following material: | |||
|
|||
Using embedded DartPad editors, you can test your knowledge by | |||
completing and running exercises. To get the most out of | |||
this codelab, you should have some knowledge of [basic Dart syntax](/language). | |||
this tutorial, you should have some knowledge of [basic Dart syntax](/language). | |||
|
|||
{{site.alert.note}} | |||
This page uses embedded DartPads to display exercises. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
suggestion: Add a link to DartPad.
This page uses embedded DartPads to display exercises. | |
This page uses embedded [DartPads](/tools/dartpad) to display exercises. |
Congratulations, you've finished the tutorial! If you'd like to learn more, here | ||
are some suggestions for where to go next: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
suggestion: Phrase as a call to action and avoid "here".
Congratulations, you've finished the tutorial! If you'd like to learn more, here | |
are some suggestions for where to go next: | |
Congratulations, you've finished the tutorial! | |
To learn more about null safety, we suggest the following topics: |
If you're interested in using embedded DartPads, like this tutorial does, see | ||
[best practices for using DartPad in tutorials](/tools/dartpad/dartpad-best-practices). | ||
If you're interested in improving this codelab, see | ||
If you're interested in improving this tutorial, see | ||
[issue #3093][]. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
question: This page isn't about DartPad, so I would delete that reference. Also, I don't recommend linking to the issue. The page has a button that can be clicked to review the code, then create an issue or PR.
Issues with the current design:
After some discussion, here's how we've decided to progress with solving this:
Add a preliminary "Getting Started" page to the top of the sidenav
Remove the "Tutorials & Codelabs" section from the side nav
Change all mentions of "codelab" to "tutorial" across the site