Skip to content

Latest commit

 

History

History
28 lines (17 loc) · 2.08 KB

CONTRIBUTING.md

File metadata and controls

28 lines (17 loc) · 2.08 KB

Contribution Guide

We welcome contributions from outside the Ensembl team and our full contribution guidelines are available here.

Please submit new plugins and updates as pull requests against the MAIN branch unless otherwise discussed.

Plugin Development

To make development of plugins easier, we suggest you use the Bio::EnsEMBL::Variation::Utils::BaseVepPlugin module as your base class, as this provides default implementations of all the necessary methods which can be overridden as required. The documentation in this module provides details of all required methods and a simple example of a plugin implementation. Also see Bio::EnsEMBL::Variation::Utils::BaseVepTabixPlugin for reading tabix-indexed files.

Ensembl VEP provides multiple output formats; it is worth testing plugins with each format for ease of parsing.

Fuller guidance on creating and using plugins for Ensembl VEP is given here.

Documentation

  • Please add NAME and DESCRIPTION sections to the POD header - these are used to automatically create documentation pages.
  • The documentation should include enough information for others to use the plugin, including:
    • full instructions on how to download and format any required data
    • full instructions on how to download and install required software
  • Also acknowledge any data/tool provider with any text they specify on their website, including the project URL and latest publication where possible.

Licence

Please add a licence and your contact details. Ensembl code is licensed under the Apache 2.0 License and our expectation is that contributed code is made available under the same License. Any copyright assertion to other organisations should be declared in the modifying file and in the root LICENSE section.