Welcome to the Eclipse LSP4E contributor land, and thanks in advance for your help in making Eclipse LSP4E better and better!
🏠 Official Eclipse LSP4E Git repo is https://github.com/eclipse/lsp4e . (All other repositories, mirrors and so on are legacy repositories that should be removed at some point, so please don't use them!)
The project license is available at LICENSE.
This Eclipse Foundation open project is governed by the Eclipse Foundation Development Process and operates under the terms of the Eclipse IP Policy.
Before your contribution can be accepted by the project team, contributors must have an Eclipse Foundation account and must electronically sign the Eclipse Contributor Agreement (ECA).
For more information, please see the Eclipse Committer Handbook: https://www.eclipse.org/projects/handbook/#resources-commit.
Eclipse LSP4E use mainly 2 channels for strategical and technical discussions
- 🐞 View and report issues through uses GitHub Issues at https://github.com/eclipse/lsp4e/issues. 📜 Migration to GitHub tracker took place in November 2021, for older tickets, see https://bugs.eclipse.org/bugs/buglist.cgi?product=lsp4e 📜
- 📧 Join the lsp4e-dev@eclipse.org mailing-list to get in touch with other contributors about project organization and planning, and browse archive at 📜 https://accounts.eclipse.org/mailing-list/lsp4e-dev
Latest builds, for testing, can usually be found at https://download.eclipse.org/lsp4e/latest/ .
Eclipse IDE with Plugin Development Environment installed for development; and Maven 3.8.x or Eclipse m2e if you want to run Maven build
- Clone this repository
for lsp4e.
- File > Open Projects from Filesystem... , select the path to LSP4E Git repo and the relevant children projects you want to import
- Depending on the task you're planning to work on, multiple workflows are available to configure the target-platform
- In many cases, this simplest workflow will be sufficient: Install latest LSP$E snapshot in your target-platform (can be your current IDE), or
- If you don't want to mix versions of LSP4E, open target-platforms/target-platform-latest/target-platform-latest.target and Set as Target-Platform from the editor, or
- Open the project modules you want to work on (right-click > Open project) and their dependencies
- Happy coding!
Just mvn clean verify.
LSP4E tries to use OSGi Semantic Version (to properly expose its API contracts and breakage) and Reproducible Version Qualifiers (to minimize the avoid producing multiple equivalent artifacts for identical source). This requires the developer to manually bump version from time to time. Some rules are that:
- Versions are bumped on a per module grain (bump version of individual bundles/features one by one when necessary), DON'T bump version of parent pom, nor of other modules you don't change
- Versions are bumped maximum once per release (don't bump versions that were already bumped since last release)
- Don't bump versions of what you don't change
- Bump version of the bundles you're modifying only if it's their 1st change since last release
- Version bump may need to be cascaded to features that include the artifact you just changed, and then to features that include such features and so on (unless the version of those features were already bumped since last release).
The delta for version bumps are:
+0.0.1(next micro) for a bugfix, or an internal change that doesn't surface to APIs+0.1.0(next minor) for an API addition+1.0.0(next major) for an API breakage (needs to be discussed on the mailing-list first)- If some "smaller" bump already took place, you can replace it with your "bigger one". Eg, if last release has org.eclipse.lsp4e 1.16.1; and someone already bumped version to 1.16.2 (for an internal change) and you're adding a new API, then you need to change version to 1.17.0
LSP4E only accepts contributions via GitHub Pull Requests against https://github.com/eclipse/lsp4e repository.