History of Contribute Code

{maketoc}
As you know, bitweaver consists of a set of core packages and a number of optional packages. New devs who join the bitweaver coding team, have immediate access to non core packages and may commit to these. When there is demand, we will grant access to the core packages. Commits to these need to be treated with more respect since they affect all packages.

! ToDo List
# Subscribe to the [http://sourceforge.net/mail/?group_id=141358|bitweaver-core] mailing list. This is a low volume mailing list where important announcements are made.
# {code title="Check out CVSROOT"}cd bitweaver/
cvs co CVSROOT
vim CVSROOT/modules
{/code}
# test

! Discuss Commits
Certain types of commits should always be discussed:
* All schema related files:
** ''package''/admin/schema_inc.php
** ''package''/admin/upgrade_inc.php
** ''package''/admin/upgrades/*
* Major changes to the behaviour of a package
* Any change that is not backwards compatible

! Schema Changes
If you do need to make schema changes (regardless of how small the changes are):
# Discuss them with the creator / maintainer of the package or one of the lead developers
# Commit schema change to ''package''/admin/schema_inc.php
# Enter the change in ((SchemaChangelog))
# Create an appropriate upgrade file in ''package''/admin/upgrades/<version>.php
# announce the schema change on the [http://sourceforge.net/mail/?group_id=141358|bitweaver-core] mailing list

!! Version Numbers
Any package can use version numbers as they see fit. __Core packages__ stick to the following rules:
||~ Rev | Rev | Rev | Desription
::__X__:: | | | This is the __major__ release version of bitweaver and indicates what version of bitweaver the core package belongs to.
| ::__Y__:: | | This is the __minor__ release which is increased when there is a schema change to that package.
| | ::__Z__:: | This is a __bug fix__ release that simply fixes issues with existing code.
||
To illustrate this with an example:
bitweaver version 2.0.0 is released and all core packages have version 2.0.0. now liberty undergoes a schema change which would bump it up to version 2.1.0 but the remainder of the core packages still remain at version 2.0.0

!! Core Packages
Core packages consist of:
* ((KernelPackage))
* ((LanguagesPackage))
* ((LibertyPackage))
* ((StoragePackage))
* ((TempPackage))
* ((ThemesPackage))
* ((UsersPackage))

! Other notes
Please make sure you view the ((CodingGuidelines)) before you start committing. We've spent a lot of time cleaning up the code and it would be a shame to mix styles and get sloppy.

Be careful when committing and always make sure you've tested your changes before committing them.