Making Contributions

Contributions , either code patches or documentation , are welcomed from the community.

For documentation contributions,

  1. Send a request to the condor-devel mailing list mailing list, and an administrator will help you

For code contributions,

  1. Grab the source code ! Also helpful to refer to BuildingHtcondorOnUnix and/or BuildingHtcondorOnWindows
  2. Open a ticket for discussing your contribution (either enhancement or bug fix); you can read about our ticket process here or by clicking [Help] at the top of the new ticket page . If your contribution is a small/trivial patch or bugfix, you could simply attach a patch file directly to the ticket page (at the top of the ticket page, select Attach ). If your change is an enhancement (new feature) or large bug fix, you will need to author and attach a design document to the ticket page for architecture review and get it approved before code contributions will be accepted. It is appreciated if you openly discuss design with committers via the htcondor-devel mailing list.
  3. Send an email to the htcondor-devel mailing list announcing your ticket to find a committer to help you
  4. Make sure: you work with a committer, your code compiles on all platforms, your code meets guidelines, you include test a procedure
  5. Assign your ticket to the committer and change its status to review

Your code contributions will be much more happily received if you observe the following guidelines:

  • Submit your contribution as a patch to most recent version of the HTCondor source code.
  • State which version of the HTCondor source your patch is relative to.
  • When generating your patch, use one of the diff formats that provides context (i.e. diff -c or diff -u ).
  • When modifying existing source files, try to match the formatting style of the surrounding code.