Skip to content

Commit 3928c19

Browse files
Added Branch guide for htk
1 parent 2c52acb commit 3928c19

File tree

2 files changed

+47
-0
lines changed

2 files changed

+47
-0
lines changed

BranchGuide.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Mixed Reality Toolkit Branch guide
2+
3+
The Mixed Reality Toolkit uses multiple working branches within the project to manage the various components of delivery, these can be broken down to:
4+
5+
---
6+
## Release Branches
7+
8+
Release branches are frozen code linked to a specific released asset, the code held within these branches should match 1-1 with their corresponding asset.
9+
This ensures whether you download the asset or the code, there are no differences in the delivery.
10+
11+
* **[master](https://github.com/Microsoft/MixedRealityToolkit-Unity) - [HoloToolkit 2017.4.2.0](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases/tag/2017.4.2.0)** - Current HoloToolkit release branch.
12+
13+
* **[mrtk_release](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/mrtk_release) - [Mixed Reality Toolkit 2018.9.0](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases/tag/2018.9.0-Beta) (vNext Beta)** - Current Mixed Reality Toolkit (vNext) beta release.
14+
15+
---
16+
## Development Branches
17+
18+
Development branches relate to the current active and tested development state of the product. These should be considered "stable", however bugs may be introduced during the course of development.
19+
20+
* **[htk_development](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/htk_development)** - HoloToolkit development branch, active for fixes needed by existing customers.
21+
22+
* **[Dev_Working_Branch](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/Dev_Working_Branch)** - Obsolete. Persists for reference purposes as vNext is completed.
23+
24+
* **[mrtk_development](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/mrtk_development)** - Current Mixed Reality Toolkit (vNext) active development
25+
26+
---
27+
## Feature Branches
28+
29+
These relate to new components / features that are actively being developed for consideration to be included in the main development branch.
30+
These should not be considered stable and main contain breaking features, **use at your own risk**.
31+
32+
> This list may not be up to date as development during the vNext beta is quite rapid, so simply use this as a guide and [ask in Slack](https://holodevelopersslack.azurewebsites.net/) regarding future features / capabilities.
33+
34+
For example, here are some of the main area that are currently being worked on:
35+
36+
* [feature/LuminPlatform](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/feature/LuminPlatform) - Experimental Magic Leap device integration.
37+
* [feature/spatialAwarenessPlanes](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/feature/spatialAwarenessPlanes) - Extensions to the Spatial Awareness framework for plane detection.
38+
* [feature/mrtk_interactable](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/feature/mrtk_interactable) - New SDK components / features and ported features from the HTK
39+
* [feature/mrtk_packageManager](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/feature/mrtk_packageManager) - New MRTK delivery development (NuGet)
40+
* [feature_mrtk_state_sharing](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/feature_mrtk_state_sharing) - Advanced networking / Sharing solution
41+
* [feature/sharing_photon_preview](https://github.com/Microsoft/MixedRealityToolkit-Unity/tree/feature/sharing_photon_preview) - Photon Based networking / sharing solution
42+
* feature/SteamVR - (future) Adding native SteamVR support
43+
44+
## Other branches
45+
Other branches are usually temporary or other experimental WIP. occasionally you will see "Staging" or "Stabilization" branches which are used temporarily for the Mixed Reality Toolkit release process

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44
The Mixed Reality Toolkit is a collection of scripts and components intended to accelerate development of applications targeting Microsoft HoloLens and Windows Mixed Reality headsets.
55
The project is aimed at reducing barriers to entry to create mixed reality applications and contribute back to the community as we all grow.
66

7+
> ### For details on the different branches used in the Mixed Reality Toolkit repositories, check this [Branch Guide here](/BranchGuide.md).
8+
79
MixedRealityToolkit-Unity uses code from the base [MixedRealityToolkit](https://github.com/Microsoft/MixedRealityToolkit) and makes it easier to consume in [Unity](https://unity3d.com/).
810

911
<img src="External/ReadMeImages/MixedRealityStack-Apps.png" width="600"><img src="External/ReadMeImages/MixedRealityStack-MRTK-Unity.png" width="600"><img src="External/ReadMeImages/MixedRealityStack-MRTK.png" width="600"><img src="External/ReadMeImages/MixedRealityStack-UWP.png" width="600">

0 commit comments

Comments
 (0)