microsoft / vscode-docs

Public documentation for Visual Studio Code
http://code.visualstudio.com/docs
Other
5.66k stars 4.6k forks source link

Regarding Java doc #7378

Open Sbrjt opened 3 months ago

Sbrjt commented 3 months ago

I was following the Getting Started with Java in VS Code doc and found it pretty confusing as a beginner.

The Setting up section asked me to install the coding pack that installed the JDK and added it to the path. But the very next section was about installing custom JDK from other websites, making me think I need to install the JDK again. And the coding pack didn't prompt me to reboot my system and javac didn't work as the changes in the path were not reflected without reboot.

I think it'd be helpful if you make the instructions more clear and add a small quick start section in the beginning:

ntrogh commented 3 months ago

@Sbrjt Appreciate you taking the time to provide constructive feedback! We'll look into how we can improve the experience.

nickzhums commented 3 months ago

thanks @Sbrjt , cc @testforstephen and @jdneo for awareness. We'll refactor this page a bit so the flow is more natural