Skip to content

Latest commit

 

History

History
22 lines (18 loc) · 1.49 KB

CONTRIBUTING.md

File metadata and controls

22 lines (18 loc) · 1.49 KB

Contributing

Please follow these contribution guidelines:

  • Each bug is represented as one or more branches, commonly named by the bug ID being checked
  • Each branch should include a Jenkinsfile that performs verification steps
  • Each branch should include a README.md that briefly describes the bug and links to the original bug report
  • Build tools are preferred to be platform portable (ant or maven)
  • Jobs are preferred to run on any available platform (windows, linux, freebsd, macos, openbsd, etc.). If they must be limited to specific platforms, use a platform label. If they require specific tools, use a tool label.
  • Platform labels are maintained by the platformlabeler plugin and include:
    • windows - Microsoft Windows
    • linux - a Linux variant (no commitment which variant, could be alpine, CentOS, Debian, Ubuntu, or several others)
    • cloud - indicate no agent access to Jenkins server root URL
  • Tool labels are manually maintained and include
    • ant-latest - latest release of Apache Ant
    • git-X.YY+ - minimum required CLI git version for the test (for example, git-1.8+ means "CLI git 1.8 or newer")

Verification is most commonly run from a derivative of the lts-with-plugins branch of docker-lfs.

Contents of this branch are checked by pre-commit for simple file consistency checks when the pre-commit program is installed on a development machine.