• Contributing to WikiTrust for External Developers

Getting the code

Create a directory where you wish to work, and get some Ocaml libraries that are needed:

git clone git://trust.cse.ucsc.edu/share/git/OcamlLdaLibs.git

and follow the instructions in the README file there.

Then, get the code of WikiTrust itself:

git clone git://trust.cse.ucsc.edu/share/git/wikitrust.git
cd wikitrust

This puts you in the master branch. This is the best place to be if you simply plan to use the code. Look at the README file for installation instructions.

Branches available

The following branches are available:

• master and stable coincide, and they contain a stable version of the code. Use this if you don't like change.

• testing provides more frequent updates than stable.

• unstable is the development version.

Keeping up to date

If you want to do bleeding-edge development, get yourself a copy of the unstable branch:

git branch --track unstable origin/unstable
git checkout unstable

and work in the unstable branch. To update it, do:

git pull

or if you prefer,

git fetch
gitk --all & 
git merge 

gitk will display to you detailed information about all changes, so you can review them before merging them in your local unstable branch via git merge.

Giving back the changes

When you want to give back the changes to us developers, proceed as follows. Either you can make patches, and email them to us, as indicated in the Git manual, or you can make your own public repository, and ask us to pull from it. We much prefer this latter way of interaction.

To create your own public repository, I will assume that your code is in ~/wikitrust. Do:

mkdir git
cd git
git clone --bare ~/wikitrust wikitrust.git
git touch wikitrust.git/git-daemon-export-ok

Then, copy ~/git/wikitrust.git to a server in a path where the git daemon can export it, and let us know the git URL for it.