= Branches =

Development of major new features for Django tends to take place in ''branches'' — copies of the main codebase focused on a particular feature.  Using branches makes it easier to experiment with such sweeping changes without possibly breaking the ''trunk'' — the main line of development.

Branches may not be stable, but they offer a chance to test out bleeding-edge code before it hits the mainline.  Give them a try, and remember to send feedback to the branch maintainers!

[[PageOutline(2,, inline)]]

== Active Branches ==

There are no active branches at this time.

== Creating New Branches ==

We are discouraging the creation of new branches inside Django's subversion repository.  If you'd like to work on a major new contribution to Django, we encourage you to set up a new "branch" elsewhere and let the Django-developers mailing list know about it.  One tactic is to use a distributed revision control system ("DRCS", or sometimes "DSCM", ''see'' [http://en.wikipedia.org/wiki/Revision_control Wikipedia's article on revision control]); these systems allow you to create your own repository anywhere you'd like, and typically include tools to import from Subversion.  Options here include [http://bazaar-vcs.org/ Bazaar], [http://git.or.cz/ Git], [http://www.selenic.com/mercurial/ Mercurial], and [http://svk.bestpractical.com/ SVK].

Please note that the information regarding branches in the [http://www.djangoproject.com/documentation/contributing/#branch-policy Contributing] document is out of date with regards to Django's branch creation policy.

== Distributed version control mirrors ==

=== Bazaar ===

[https://launchpad.net/ Launchpad] mirrors Django's trunk: https://launchpad.net/django

You can fetch it with:
{{{
bzr branch lp:django
}}}

=== Git ===

There are several git repositories out there, some of which are used to develop patches that will come to SVN.

 * Matthias Kestenholz has set up several git repositories for Django and for a selection of Django applications:
   * Gitweb with complete list of repositories: http://spinlock.ch/pub/git/
   * The django changes are sporadically published on repo.or.cz: http://repo.or.cz/w/django.git/
 * Jacob Kaplan-Moss has also set up an experimental git mirror ([http://groups.google.com/group/django-developers/browse_thread/thread/7c96cbb1a13aa368 django-developers post]):
   * Repository: git://djangoproject.com/django [http://code.djangoproject.com/git/?p=django (browse)]
 * Other people also published their repositories, in case you want to add them as remotes:
   * brosner: git://github.com/brosner/django.git [http://github.com/brosner/django/tree/master (browse)]
   * telenieko: http://www.marcfargas.com/git/django.git/ [http://www.marcfargas.com/gitweb/?p=django.git;a=summary (browse)]

=== Mercurial (hg) ===

 * [Preferred] Full Mercurial mirror hosted at dpaste.com, updated every fifteen minutes: http://hg.dpaste.com/django/
 * SVN2HG Gateway of Django and Active branches, updated hourly: [http://hgsvn.trbs.net/django/]
 * [http://geodjango.org/hg/ GeoDjango Mercurial]: includes `gis-newforms` (a merge of the `gis` and `newforms-admin` branches), example code, and other geospatial goodies.