Intro

This document will provide a brief overview of working with the Joomla Platform repository on github.com for people who are interested in making code contributions and using eclipse as an IDE. Much will also apply for people who just want to follow development, but that is much simpler.

Some preliminary information.

What is Git?

Git is distributed version control software. Such software (another example is Mercurial while subversion and CVS are non distributed version control systems) allow many people to contribute code to a single project and also allow for well defined tracking of code changes and provide mechanisms for recording commit by commit records of changes.

What is Github?

What is the Joomla! CMS?

This Article Needs Your Help

This article is tagged because itNEEDS CONTENT. You can help the Joomla! Documentation Wiki by contributing to it.More pages that need help similar to this one are here.NOTE-If you feel the need is satistified, please remove this notice.Reason: article title is generic, a little expansion could make this a real good generic starter overview

What is the Joomla! Platform?

The Joomla! Platform also known as the Joomla! Framework is the set of libraries that are used to build the Joomla! CMS and other applications.

The platform is managed separately from the CMS and has its own release cycle; each release of the CMS uses one specific version of the platform.

Getting Started

Setup a Github account

Once registered, you will probably want to go to github.com/joomla/joomla-platform and click follow. Then whenever you log in you will see the latest things that have happened in the repository.

If you are going to code, you will also want to click on fork. This will give you your own copy of the platform to work with. You'll probably want to follow that too.

Install Git

Now you will want to install git on your local workstation. Github provides excellent instructions on how to do this that will detect your operating system. Simply click on the Set Up Git button.

You will need to set up SSH. As it says on the Github instructions " Setting them up is fairly easy, but does involve a number of steps." Some will be specific to your operating system, so follow the instructions at github.

You will also need to tell Git your user name and password so that it can connect to your repositories on github.

Methods of Using Git

Command Line

If you like using the command line, git by itself provides commands to create a local copy of your fork at github. There are a number of tutorials and reference sites for git including:

Using Eclipse

Working on Joomla! Code

Getting to Work

Once you have your repository you are ready to start working on code. Whenever you have some code that you are happy with, you should commit it locally. Note that unless you commit, your local changes will not enter into version control. To commit, you click Team>commit.

Creating patches

The most painless method seems to be the command line as described on the git home page as a quick start "Cloning and Creating a Patch"

Beyond the Basics

Further steps

This article is tagged because itNEEDS CONTENT. You can help the Joomla! Documentation Wiki by contributing to it.More pages that need help similar to this one are here.NOTE-If you feel the need is satistified, please remove this notice.

Trouble Shooting

If you get a message about unpacking try adding .git to the end of the remote repository url.