rolim/tinyos-main

Main development repository for TinyOS (an OS for embedded, wireless devices).

This is the TinyOS main development GIT repository.

It is hosted at https://github.com/tinyos/tinyos-main, main branch master. (aka gh:tinyos/tinyos-main(master))

============================================================================

** Where to begin: **

README.md (this file). For a general overview of what this Repo is about. This repository uses GIT as its DVCS.

doc/00a_Getting_Started: Overview of getting started using git, github.

doc/00b_Using_the_Repo: Using and contributing back to the central Repository.

============================================================================

• About tinyos-main.

Long ago (well not that long ago), in a galaxy not too distant, tinyos development was hosted on Google Code as the subversion repository, tinyos-main.googlecode.com/svn/trunk. This repository is writeable by a select group of core developers.

TinyOS development is moving to a fully distributed model to encourage more participation and is switching to the GIT distributed version control system to support this.

To ease the transition the gh:tinyos/tinyos-main repository will support very similar access mechanisms as currently being used to write to the tinyos-main subversion repository. The core group of lead developers has push (write) permission to the main development repository.

• Repo Structure

Currently there is a single mainline, master. gh:tinyos/tinyos-main(master). This is equivilent to the tip of the svn trunk.

Branches are very inexpensive and are encouraged for any significant development. Typically, a feature will be implemented on a topic branch, ie. -int. where stands for integration.

For the immediate future, branching should be done in private user repositories until the community gets used to how they work.

The general form for a repository/branch reference is: <github_context>/(branch) ie. gh:tinyos/tinyos-main(master) is the master branch in the tinyos/tinyos-main repository. Note that github repositories have a specific default branch controlled by github repository settings. gh:tinyos/tinyos-main refers to the repository but if that repository is pulled it will reference the default branch.

Local repositories are referenced using local(branch).