How to contribute

How to Contribute Elixirs & Conchs

Want to share your elixir (LangServe app) or conch (OpenMRS O3 ESM/CDS Hooks client) with the DHTI community? Follow this checklist for a smooth contribution:

Checklist

• Naming
  • Elixirs: Prefix with dhti-elixir- (e.g., dhti-elixir-fhire)
  • Conchs: Prefix with openmrs-esm- or descriptive name (e.g., openmrs-esm-dhti-template)
• README
  • Brief description and purpose
  • Quickstart instructions (install, run, test)
  • Example usage/screenshots if possible
• License
  • Include an open-source license file (MIT, Apache 2.0, etc.)
• Minimal Config
  • Elixirs: Provide a working bootstrap.py or config file
  • Conchs: Document required environment variables or endpoints
• Versioning
  • Use semantic version tags (e.g., 1.0.0)
• Tested with DHTI
  • Confirm it works with the latest DHTI stack (see Getting Started)
• Link
  • Create an issue to add your repo to List of open-source elixirs or List of open-source conchs via PR

Tips

• Keep dependencies minimal and document any special requirements.
• Use issues and discussions for feedback and support.
• See templates: elixir, conch