README.md 15 KB

PHPUnit Tests All Contributors Documentation Status

DOI

alt tag

Welcome to the home of Tripal Development! If you are thinking to yourself "What is Tripal?", head over to our website, Tripal.info.

Current Status

  • Recommended Version: GitHub release (latest by date)
  • Development:
    • Tripal 3: Focus is on bug fixes
    • Tripal 4: Full upgrade to Drupal 8/9 (development in T4D8 Repository).
  • Tripal Tripal 1.x and Tripal 2.x are no longer supported by the Project Management Committee, although we will accept community submitted fixes for Tripal 2.x.

# Resources

Contribution

Looking to contribute? That's Amazing -Welcome!!! Here's a quick run-down to get you started:

  • We welcome all contributions!
  • This github issue queue is open to: bug reports, usability concerns, performance issues, site administration or development questions, data storage discussions, etc.
  • We ask that questions/concerns/bugs with extension modules be addressed in their respective repositories (including those under the Tripal organization).
  • For feature request, please open an issue with detailed use cases and description. We would love to help you design a generic solution for the community whether it belongs in Tripal Core or an Extension module! Please wait to submit a PR until the Project Management Committee (PMC) indicates it is generally applicable and should be included in Core.
  • For potential bugs or concerns, please open an issue being as descriptive as possible. Screenshots and steps to reproduce will help us, help you! If you know how to fix the issue, feel free to submit a pull request (PR) linked to the issue!
  • For documentation contributions, click the "Edit on Github" link at the top of the page you want to improve! Instructions for our flavour of ReadtheDocs can be found on ReadtheDocs.
  • See our quickstart if you need help on how to submit a PR: ReadtheDocs, how to create a PR.
  • Click on issues > New Issue for helpful issue templates.
  • For Tripal 4 (Drupal 8/9), see the T4D8 repository.

For more detailed guidelines see our full Contribution Documentation!

Github Communication Tips

  • Don’t be afraid to mention people (@username) who are knowledgeable on the topic or invested. We are academics and overcommitted, it’s too easy for issues to go unanswered: don’t give up on us!
  • Likewise, don’t be shy about bumping an issue if no one responds after a few days. Balancing responsibilities is hard.
  • Want to get more involved? Issues marked with “Good beginner issue” are a good place to start if you want to try your hand at submitting a PR.
  • Everyone is encouraged/welcome to comment on the issue queue! Tell us if you
    • are experiencing the same problem
    • have tried a suggested fix
    • know of a potential solution or work-around
    • have an opinion, idea or feedback of any kind!
  • Be kind when interacting with others on Github! (see Code of Conduct below for further guidelines). We want to foster a welcoming, inclusive community!
    • Constructive criticism is welcome and encouraged but should be worded such that it is helpful :-) Direct criticism towards the idea or solution rather than the person and focus on alternatives or improvements.

Code of Conduct

Be nice! If that’s insufficient, Tripal community defers to https://www.contributor-covenant.org/

Required Dependencies

  • Drupal:
    • Drupal 7.x
    • Drupal core modules: Search, Path and PHP modules.
    • Drupal contributed modules:
    • Views
    • Entity API
  • PostgreSQL 9.3 or higher (9.5 required for Chado 1.2 to 1.3 upgrade)
  • PHP 5.5+
  • UNIX/Linux

Development Testing

To run PHP unit tests on your local system, run composer install to install developer-specific requirements. Next, create a .env file in your /Tests/ directory that defines the DRUPAL_ROOT variable, for example

DRUPAL_ROOT=/var/www/html

Then run PHPUnit from your root Tripal directory.

PHPUnit tests will also be run in the Travis CI build.

Read our testing guidelines.

Contributors

Thanks goes to these wonderful people (emoji key):


Stephen Ficklin

💻 📋 📖 📆 👀

Bradford Condon

💻 📖 📆 📋 👀

Lacey-Anne Sanderson

💻 📖 📆 📋 👀

chunhuaicheng

💻

Shawna

💻 🖋 📖 👀

mboudet

🐛

Valentin Guignon

🐛

Meg Staton

🔍 📋

Anthony Bretaudeau

💻

colthom

📖

Abdullah Almsaeed

💻 👀

btski

💬

ekcannon

🤔 📋

jlwegrzyn

🔍

Douglas Senalik

💻 💬

par12005

💻 💬

Sofia Robb

💻

katherynbuble

💻

risharde

💻

Pierre Grimaud

📖

This project follows the all-contributors specification. Contributions of any kind welcome!