Skip to content
This repository has been archived by the owner on Sep 7, 2022. It is now read-only.

Latest commit

 

History

History
63 lines (42 loc) · 2.63 KB

CONTRIBUTING.rst

File metadata and controls

63 lines (42 loc) · 2.63 KB
Raw

Contributing

BioKEEN is part of the KEEN Universe with which we aim to make knowledge graph embedding research reproducible and transferable to other domains. Contributions, whether big or small, are appreciated! You can get involved by submitting an issue, making a suggestion, or adding code to the project.

Having a Problem? Submit an Issue.

  1. Check that you have the latest version of BioKEEN
  2. Go here: https://github.com/SmartDataAnalytics/BioKEEN/issues
  3. Check that this issue hasn't been solved
  4. Click "new issue"
  5. Add a short, but descriptive title
  6. Add a full description of the problem, including the code that caused it and any support files related to this code so others can reproduce your problem
  7. Copy the output and error message you're getting

Have a Question or Suggestion?

Same drill! Submit an issue and we'll have a nice conversation in the thread.

Want to Contribute?

  1. Get the code. Fork the repository from GitHub using the big button in the top-right corner of https://github.com/SmartDataAnalytics/BioKEEN

  2. Clone your directory with

    $ git clone https://github.com/<YourUsername>/SmartDataAnalytics/BioKEEN.git

  3. Install with pip. The flag, -e, makes your installation editable, so your changes will be reflected automatically in your installation.

    $ cd biokeen $ python3 -m pip install -e .

  4. Make a branch off of develop, then make contributions! This line makes a new branch and checks it out

    $ git checkout -b feature/<YourFeatureName>

  5. This project should be well tested, so write unit tests in the tests/ directory

  6. Check that all tests are passing and code coverage is good with tox before committing.

    $ tox

Pull Requests

Once you've got your feature or bugfix finished (or if its in a partially complete state but you want to publish it for comment), push it to your fork of the repository and open a pull request against the develop branch on GitHub.

Make a descriptive comment about your pull request, perhaps referencing the issue it is meant to fix (something along the lines of "fixes issue #10" will cause GitHub to automatically link to that issue). The maintainers will review your pull request and perhaps make comments about it, request changes, or may pull it in to the develop branch! If you need to make changes to your pull request, simply push more commits to the feature branch in your fork to GitHub and they will automatically be added to the pull. You do not need to close and reissue your pull request to make changes!