Thank you for your interest in contributing to our project. Whether it's a bug report, new feature, correction, or additional documentation, we greatly value feedback and contributions from our community.
Please read through this document before submitting any issues or pull requests to ensure we have all the necessary information to effectively respond to your bug report or contribution.
We welcome you to use the GitHub issue tracker to report bugs or suggest features.
When filing an issue, please check existing open, or recently closed, issues to make sure somebody else hasn't already reported the issue. Please try to include as much information as you can. Details like these are incredibly useful:
- A reproducible test case or series of steps
- The version of the plugin being used, which Eclipse IDE product being used (and version)
- Anything unusual about your environment (e.g. recently installed plugins etc.)
- Clone this GitHub repository.
- From the root of the workspace, run
mvn package
- Find the resulting plugin JAR:
plugin/target/amazon-q-eclipse-<version>-SNAPSHOT.jar
- Copy this file to your Eclipse installation's
dropins
folder. The location is platform dependent. On Windows, it is typically found at<eclipse_install_dir>\dropins
. On Mac,Eclipse.app/Contents/Eclipse/dropins
(use "Show Package Contents" to open the app). On Linux,<eclipse_install_dir>/dropins
. - If it was running, close your IDE. Launch Eclipse and the plugin should be running. Note: make sure additional versions of the plugin are not installed to avoid conflicts.
Contributions via pull requests are much appreciated. Before sending us a pull request, please ensure that:
- You are working against the latest source on the main branch.
- You check existing open, and recently merged, pull requests to make sure someone else hasn't addressed the problem already.
- You open an issue to discuss any significant work - we would hate for your time to be wasted.
To send us a pull request, please:
-
Fork the repository
-
Modify the source; please focus on the specific change you are contributing. (note: all changes must have associated automated tests)
-
Ensure local tests pass by running:
./mvn package
-
Commit to your fork using clear commit messages. Again, reference the Issue # if relevant.
-
Send us a pull request by completing the pull-request template.
-
Pay attention to any automated build failures reported in the pull request.
-
Stay involved in the conversation.
GitHub provides additional documentation on forking a repository and creating a pull request.
To test your changes locally, you can run the plugin from your workspace by importing it into Eclipse.
- First, make sure you have the Eclipse IDE for Enterprise Java and Web Developers version of Eclipse installed which has all necessary dependencies to build and run the plugin.
- From Eclipse,
File->Import...
and selectMaven->Existing Maven Projects
. - Select the checked out plugin repository folder.
- You should see multiple projects identified. For plugin changes, you only need to select the
plugin/pom.xml
sub project. Leave the others unchecked. - This should import the project into your workspace. Eclipse will automatically build changes as you make them. To run the project, select
Run As->Eclipse Application
from theRun
menu. This will start an Eclipse instance with your local plugin instance running.
This project has adopted the Amazon Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
See the LICENSE file for our project's licensing. We will ask you confirm the licensing of your contribution.
We may ask you to sign a Contributor License Agreement (CLA) for larger changes.