Thanks for your interest in the Memory Analyzer project!
The Eclipse Memory Analyzer is a fast and feature-rich Java heap dump analyzer that helps you find memory leaks and reduce memory consumption.
- Memory Analyzer web site: http://eclipse.dev/mat/
The Memory Analyzer code is hosted on Github.
https://github.com/eclipse-mat/mat
Information regarding setting up your development environment, building MAT, running tests, coding standards, and more.
- Contributor Reference
- Developers area on the MAT web site
- The section "Eclipse Contributor Agreement" below describes the formal requirements for contributing to an Eclipse project
- Fork the MAT repository on GitHub
- Clone the forked repository onto your computer:
git clone https://github.com/<your username>/mat.git
and checkout themaster
branch - See MemoryAnalyzer/Contributor Reference for instructions on setting up a local development environment for MAT
- Make your changes
- Ensure that all new and existing tests pass.
- Commit the changes into the branch:
git commit -s
Make sure that your commit message is meaningful and describes your changes correctly. - If you have a lot of commits for the change, squash them into a single / few commits.
- Push the changes in your branch to your forked repository.
- Consider opening an issue on the MAT project to discuss your contribution
- Finally, go to
https://github.com/eclipse-mat/mat
and create a pull request from your "YOUR_BRANCH_NAME" branch to the
master
branch to request review.
What happens next depends on the content of the patch. If it is 100% authored by the contributor and is less than 1000 lines (and meets the needs of the project), then it can be pulled into the main repository. If not, more steps are required. These are detailed in the legal process poster.
In order for your contribution to be accepted, it must comply with the Eclipse Foundation IP policy.
- You need to electronically sign the Eclipse Contributor Agreement (ECA). Find more information in the ECA FAQ.
- Register for an Eclipse Foundation User ID. You can register here.
- Log into the Accounts Portal, and click on the 'Eclipse Contributor Agreement' link.
- Go to your account settings and add your GitHub username to your account.
- Make sure that you sign-off your Git commits in the following format:
Signed-off-by: John Smith <[email protected]>
This is usually at the bottom of the commit message. You can automate this by adding the '-s' flag when you make the commits. e.g.git commit -s -m "Adding a cool feature"
- Ensure that the email address that you make your commits with is the same one you used to sign up to the Eclipse Foundation website with.
For more details see Eclipse Foundation policy on accepting contributions via Git.
Contact the project developers via the project "dev" list.
This project uses Bugzilla to track ongoing development and issues.
Be sure to search for existing bugs before you create another one. Remember that contributions are always welcome!