From 1ddf933c5dbbdbea41649d39f44e75651b15cef8 Mon Sep 17 00:00:00 2001 From: Brad Davis Date: Fri, 13 Sep 2013 11:56:57 -0700 Subject: Updating the README --- README.md | 49 +++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 39 insertions(+), 10 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index b79d26b..e317d65 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,49 @@ OculusSDK ========= -Oculus SDK with modifications for Linux development and Java development. The -'master' branch will attempt to track the publicly released SDK version, while -additional branches will be used for my custom modifications. +Oculus SDK with additional community supported features and bug-fixes. + +Goals +----- + +* Providing new features + * C bindings + * Python bindings + * Java bindings +* Providing new tools + * Command line diagnostics for people having trouble with Rift detection +* Providing new sample code + * Alternative mechanisms for rendering the Rift distortion + * Sample code for the non-C++ language bindings +* Helping developers write better or easier Oculus Rift compatible software + +Licensing +--------- All code not explicitly marked with another license is made available under the terms of the Oculus SDK license, included in this kit as LICENSE.TXT and available online at https://developer.oculusvr.com/license and is Copyright 2013 Oculus VR, Inc. -Currently the 'linux' branch contains modifications to the SDK that allow the -SensorBox sample to function with my local Ubuntu 13.04 distribution. It is -currently a work in progress and no guarantee is made that you will be able to -compile or run the application without significant effort installing dependencies -and or fiddling with Makefiles. Good luck! +Branches +-------- + +### official +This branch will track the SDK releases from Oculus VR. It should contain only files that are included in the official +SDK, as well as the minimal additional files to get it to play well with GitHub. Specifically this README file for the +uninitiated and a .gitignore file to exclude artifacts from the official SDK that we do not wish to track in GitHub. +The latter mostly consists of the binary files distributed with the SDK and documentation or any other artifacts +with unknown or suspect licensing that would prohibit reproduction on GitHub. + +### stable +Contains features that are considered complete and safe to use. + +### unstable +The tip of shared development. Contains features that may not have been merged into stable. Not guaranteed to work +at any given time. + +### feature-XXX +Feature branches for changes that will require significant time and codebase changes to function, but +which may be being developed in a team or made available for testing to the general public. + -June 2013 -Brad Davis \ No newline at end of file -- cgit v1.2.3