Skip to content

Latest commit

 

History

History
executable file
·
45 lines (30 loc) · 4.17 KB

CONTRIBUTING.md

File metadata and controls

executable file
·
45 lines (30 loc) · 4.17 KB
Raw

How to Contribute

DSpace is a community built and supported project. We do not have a centralized development or support team, but have a dedicated group of volunteers who help us improve the software, documentation, resources, etc.

Contribute new code via a Pull Request

We accept GitHub Pull Requests (PRs) at any time from anyone. Contributors to each release are recognized in our Release Notes.

Code Contribution Checklist

  • PRs should be smaller in size (ideally less than 1,000 lines of code, not including comments & tests)
  • PRs must pass Checkstyle validation based on our Code Style Guide.
  • PRs must include Javadoc for all new/modified public methods and classes. Larger private methods should also have Javadoc
  • PRs must pass all automated tests and include new/updated Unit or Integration tests based on our Code Testing Guide.
  • If a PR includes new libraries/dependencies (in any pom.xml), then their software licenses must align with the DSpace BSD License based on the Licensing of Contributions documentation.
  • Basic technical documentation should be provided for any new features or changes to the REST API. REST API changes should be documented in our Rest Contract.
  • If a PR fixes an issue ticket, please link them together.

Additional details on the code contribution process can be found in our Code Contribution Guidelines

Contribute documentation

DSpace Documentation is a collaborative effort in a shared Wiki. The latest documentation is at https://wiki.lyrasis.org/display/DSDOC7x

If you find areas of the DSpace Documentation which you wish to improve, please request a Wiki account by emailing [email protected]. Once you have an account setup, contact @tdonohue (via Slack or email) for access to edit our Documentation.

Help others on mailing lists or Slack

DSpace has our own Slack community and Mailing Lists where discussions take place and questions are answered. Anyone is welcome to join and help others. We just ask you to follow our Code of Conduct (adopted via LYRASIS).

Join a working or interest group

Most of the work in building/improving DSpace comes via Working Groups or Interest Groups.

All working/interest groups are open to anyone to join and participate. A few key groups to be aware of include:

  • DSpace 7 Working Group - This is the main (mostly volunteer) development team. We meet weekly to review our current development project board, assigning tickets and/or PRs.
  • DSpace Community Advisory Team (DCAT) - This is an interest group for repository managers/administrators. We meet monthly to discuss DSpace, share tips & provide feedback back to developers.