redhat-developer / redhat-developer/vscode-java
Outdated "Contribute a Java Extension" Wiki
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 2.3k
- Forks
- 546
- Avg merge
- 20h 1m
- Merged PRs (30d)
- 11
Description
The "Contribute a Java Extension" Wiki is outdated and impossible to follow.
Environment
- Operating System: Microsoft Windows [Version 10.0.18363.535]
- JDK version: 13.0.1
- Visual Studio Code version: 1.42.0-insider
- Java extension version: 0.55.2
Steps To Reproduce - Please attempt to reproduce!
- Forget all prior knowledge of how to create a vscode-java extension.
- Create a fresh Eclipse IDE for Java Developers installation.
- In a clean, new project directory, attempt to follow the wiki and put together a server bundle using only the steps and information provided by the wiki and its external links.
- Fail.
- Repeat continuously for days/weeks.
Current Result
It is impossible to "Contribute a Java Extension"
Expected Result
A simple, easy to follow guide on how to get started creating a Java extension. A working example project would be preferred.
Additional Information
While this may have sounded harsh it is a result of my frustration. I find it absurd that a requirement of creating an extension to a plugin for your favorite lightweight IDE is the installation of a resource heavy IDE which the user may loathe using.
@testforstephen if it is possible to do, would you mind creating a sample project which leverages your vscode-pde to create an extension targeting the eclipse.jdt.ls currently in use by vscode-java?
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the "Contribute a Java Extension" wiki, its external links, and the vscode-pde project mentioned in the issue. Verify the documented process against eclipse.jdt.ls and identify the missing or outdated steps. Done means a newcomer can follow the guide and use a working example project to create a Java extension.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java, vscode
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100