Development Tools

Overview of Trafodion project tools

Defect Tracking

JIRA: https://issues.apache.org/jira/browse/TRAFODION

In order to have certain permissions, including assigning issues to yourself, you need to be a Contributor in the project. You can ask to be added by sending a request to the dev mail list, referencing your JIRA user ID.

Code Repository

We use git to manage code versions.

Apache Repo: https://git-wip-us.apache.org/repos/asf/incubator-trafodion.git

GitHub Mirror: https://github.com/apache/incubator-trafodion

Code Review

We use GitHub pull-requests for code review. All of the activity on github is captured in ASF JIRA and/or ASF project mail archives by ASF INFRA team automation. In this way, we do not depend on github for accurate history of where contributions come from.

Current pull requests: https://github.com/apache/incubator-trafodion/pulls

Each pull-request title should start with a JIRA ID in brackets, so that activity can be logged to the correct JIRA issue.

Regardless of the title, the pull-request activity is also logged to the codereview mail list: http://mail-archives.apache.org/mod_mbox/incubator-trafodion-codereview/

GitHub Tips

GitHub Account

If you do not already have an account, sign-up for one: https://github.com/join

Add your SSH public key: https://github.com/settings/ssh

Using the https or ssh (git@github.com) protocols is handy in case your firewall blocks the git:// protocol.

Hub

Hub is a handy git wrapper for working with github. See https://hub.github.com/

1. Download pre-compiled version from https://github.com/github/hub/releases and un-tar the package.
2. cp hub ~/bin                                                      # or somewhere in your $PATH
3. If git protocol is blocked by your firewall, set the default protocol to https
   • git config --global hub.protocol https
4. cp etc/hub.bash_completion.sh ~/lib                 # somewhere to reference it in your .bashrc file

5. Update your shell resource file:

   ~/.bashrc Expand source

   source ~/lib/hub.bash_completion.sh
   alias git=hub

Git Customization

Bash customization is highly recommended if you are a regular git user. Command completion enables the shell to auto-complete git sub-commands, branch names, etc.

Source the command completion and prompt files in via your shell resource file:

source /usr/share/doc/git-*/contrib/completion/git-completion.bash
source /usr/share/doc/git-*/contrib/completion/git-prompt.sh
# some versions of git it is elsewhere:
# source /etc/bash_completion.d/git

# Set multi-color, git-aware prompt (git branch and working dir) - customize as desired
# bash(1) colors:  http://www.cplusplus.com/forum/unices/36461/
# 2;33 = dark yellow
# 0;31 = red
# 0m = default color
# \! = command history number
# \w = working dir
PS1='\033[2;33m# \! $(__git_ps1 "\033[0;31m(%s)\033[2;33m ")\w\n\033[2;33m#> \033[0m'

Related articles