microsoft / microsoft/vscode-docs

Regarding Java doc

Open
#7,378 2 comments 0 reactions 1 assignee View on GitHub

@nickzhums is already working on this.

Since Jun 18, 2024.

doc-enhancement
Dominant language
Markdown
Stars
6.6k
Forks
5.8k
Avg merge
11h 43m
Merged PRs (30d)
123

Description

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:

  • Download and run the Coding Pack for Java.
  • In VS code install the Extension Pack for Java.
  • Restart the system.
  • Run java with ▶️ button.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.