Skip to content
Kent Knox edited this page Aug 13, 2013 · 3 revisions

Repository workflow and development process

This repository follows the git flow workflow

  • A gitflow extention has been developed to ease the use of the 'git flow' methodology, but requires manual installation by the user. Refer to the projects wiki

Additional pages

Infrastructure documents

Design documents

Contributing code

Cloning clBLAS source from GitHub

There are a variety of git clients for both the Windows® and Linux® platforms. For those familiar with git, the quick instructions is to issue a git clone <https://github.com/clMathLibraries/clBLAS> command with a preferred git client. For those not familiar with git, first install a git client on the host OS in order to 'clone' the BLAS code onto the computer. For Linux ®, if git is not included in your distribution (type git –version at the commandline to verify), then most likely the native OS's package manager system can be used to easily install the git package. The package is usually called 'git' or 'git-core'.

On Windows®, a variety of distributions exist, but typically requires a manually install from a package downloaded from the web. A highly recommended distribution is GitHub for Windows. It will help to create a GitHub account if one does not already exist, and simplifies the login process by eliminating the need to enter credential information every time the github server is contacted. It also provides a posh-git prompt, which is a powershell environment for git which allows for advanced functionality. Another acceptable distribution is the mingw compiled version of git available from git-scm, which is a bare-bones version of git without the benefit of a GUI, akin to the experience on linux.

Forking the clBLAS source from GitHub

GitHub creates the concept of forking a project, similar in nature but separate from the idea of cloning a project. With a github user account, it is possible to 'fork' a project into your personal account repository which is a complete copy of the original repository. At the top right corner of the clBLAS GitHub page is a button that forks the clBLAS code. GitHub provides an introductory tutorial using their spoon-knife repository. The fork will have a different upstream URL that includes the new users account name and can be used to start hacking on the code. When the feature, bug fix or modification is finished, a 'pull request' can be issued back to the original project if the code contribution will be useful.