Update VS Code page #5958
Update VS Code page #5958
Conversation
|
Visit the preview URL for this PR (updated for commit 9cadd8d): |
src/content/tools/vs-code.md
Outdated
| To build and debug apps, | ||
| you can use the [VS Code][] integrated development environment. |
There was a problem hiding this comment.
This sentence seems unnecessary, repeats lines 7-9
src/content/tools/vs-code.md
Outdated
| ## Dart Extension documentation | ||
|
|
||
| To learn more about the features of the VS Code Dart extension, | ||
| consult its [documentation][]. |
There was a problem hiding this comment.
I'd remove this section in favor of just linking to the documentation in the intro of the previous section (the way I rewrote it)
| consult its [documentation][]. | ||
|
|
||
| [Dart extension]: https://marketplace.visualstudio.com/items?itemName=Dart-Code.dart-code | ||
| [documentation]: https://dartcode.org/docs/ |
There was a problem hiding this comment.
I think the Marketplace link is better because it lists all the pertinent information upfront. It also links to this page, so I think linking only to the Marketplace page is sufficient.
There was a problem hiding this comment.
Looks like you can remove this since you're not using it anymore
src/content/tools/vs-code.md
Outdated
| ## Dart Extension documentation | ||
|
|
||
| To learn more about the features of the VS Code Dart extension, | ||
| consult its [documentation][]. |
There was a problem hiding this comment.
Instead of this section, why not point to the Flutter VS Code docs:
| ## Dart Extension documentation | |
| To learn more about the features of the VS Code Dart extension, | |
| consult its [documentation][]. | |
| ## Flutter VS Code documentation | |
| The Flutter documentation contains more in-depth, Flutter-specific | |
| VS Code content on [setting up an editor][] and [using VS Code][] | |
| to develop Flutter apps. | |
| [setting up an editor]: {{site.flutter-docs}}/get-started/editor?tab=vscode | |
| [using VS Code]: {{site.flutter-docs}}/tools/vs-code |
src/content/tools/vs-code.md
Outdated
| With the Dart extension installed, | ||
| you can compile, deploy, and debug Dart apps. |
There was a problem hiding this comment.
Again, seems like another unnecessary repetition of the intro sentence lines 7-9. Instead I'd start this section something like:
| With the Dart extension installed, | |
| you can compile, deploy, and debug Dart apps. | |
| The Dart extension for VS Code enables support for | |
| Dart and Flutter specific development, | |
| like syntax highlighting, package resolution, hot reload, and more. | |
| For the full list of features, | |
| see the [extension documentation][Dart extension] |
Also, you rewrote the original lines 7-9 that started with "With the Dart plugin...", but then used that same structure here ("With the Dart extension..."). Is starting a sentence like that something that needs to be rewritten or not?
There was a problem hiding this comment.
Eh, it could go either way.
| consult its [documentation][]. | ||
|
|
||
| [Dart extension]: https://marketplace.visualstudio.com/items?itemName=Dart-Code.dart-code | ||
| [documentation]: https://dartcode.org/docs/ |
There was a problem hiding this comment.
Looks like you can remove this since you're not using it anymore
Fixes #4057