diff options
author | Tim Bielawa <tbielawa@redhat.com> | 2017-04-27 11:56:54 -0400 |
---|---|---|
committer | Tim Bielawa <tbielawa@redhat.com> | 2017-04-28 10:36:11 -0400 |
commit | 7de281c7a8ddfcde6b416e3c4b0b2abb6c6c67a7 (patch) | |
tree | 3624ff1d64dbb390624c0feca32d73789ea39dee /hack/hooks/README.md | |
parent | 4a553433d13ebd13499b39a94f5d79968e1d8934 (diff) | |
download | openshift-7de281c7a8ddfcde6b416e3c4b0b2abb6c6c67a7.tar.gz openshift-7de281c7a8ddfcde6b416e3c4b0b2abb6c6c67a7.tar.bz2 openshift-7de281c7a8ddfcde6b416e3c4b0b2abb6c6c67a7.tar.xz openshift-7de281c7a8ddfcde6b416e3c4b0b2abb6c6c67a7.zip |
Contrib: Hook to verify modules match assembled fragments
Diffstat (limited to 'hack/hooks/README.md')
-rw-r--r-- | hack/hooks/README.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/hack/hooks/README.md b/hack/hooks/README.md new file mode 100644 index 000000000..ef870540a --- /dev/null +++ b/hack/hooks/README.md @@ -0,0 +1,37 @@ +# OpenShift-Ansible Git Hooks + +## Introduction + +This `hack` sub-directory holds +[git commit hooks](https://www.atlassian.com/git/tutorials/git-hooks#conceptual-overview) +you may use when working on openshift-ansible contributions. See the +README in each sub-directory for an overview of what each hook does +and if the hook has any specific usage or setup instructions. + +## Usage + +Basic git hook usage is simple: + +1) Copy (or symbolic link) the hook to the `$REPO_ROOT/.git/hooks/` directory +2) Make the hook executable (`chmod +x $PATH_TO_HOOK`) + +## Multiple Hooks of the Same Type + +If you want to install multiple hooks of the same type, for example: +multiple `pre-commit` hooks, you will need some kind of *hook +dispatcher*. For an example of an easy to use hook dispatcher check +out this gist by carlos-jenkins: + +* [multihooks.py](https://gist.github.com/carlos-jenkins/89da9dcf9e0d528ac978311938aade43) + +## Contributing Hooks + +If you want to contribute a new hook there are only a few criteria +that must be met: + +* The hook **MUST** include a README describing the purpose of the hook +* The README **MUST** describe special setup instructions if they are required +* The hook **MUST** be in a sub-directory of this directory +* The hook file **MUST** be named following the standard git hook + naming pattern (i.e., pre-commit hooks **MUST** be called + `pre-commit`) |