Did you know that Rocket Software has lots of sample code and demos on GitHub? The main repository for Rocket MV can be found at https://www.github.com/RocketSoftware/multivalue-lab. You’ll find resources organized into U2 and D3 main directories, and underneath that should be a self explanatory structure of demos organized by technology.
What is GitHub?
“GitHub is a web-based Git repository hosting service, which offers all of the distributed revision control and source code management (SCM) functionality of Git as well as adding its own features” according to Wikipedia.
So GitHub is a central web-based location to host Git repositories. Git by itself is a distributed revision control system originally developed by Linus Torvalds, and has become the most widely adopted version control system, especially for open source projects. It has become a default for collaboration on software development. However, Git alone is a command line interface, so GitHub and GitHub for Windows/Mac gives a place to store those repositories and a handy way to interact with them locally as well.This also becomes a great place for organizations to share demo code and other resources, which also allows for community contribution.
GitHub Bootcamp at https://www.github.com is a great place to get an overview of how to use all the features of GitHub.
Using Rocket MV GitHub
The MultiValue repository contains code and demos for UniVerse, UniData, and D3, all organized in a directory structure. When you download or clone the repository, you will get the entire repository, containing all examples. There is no way to only retrieve specific sub-folders through Git.
The MultiValue repository in GitHub is open to the public, but changing and directly committing code to the main branch is not available to just anyone. This is where forking and pull requests come in.
Don’t plan on submitting changes?
If you just want to look around and not make any changes, you can either use the GitHub browser interface and just navigate to the desired file, or you can download a zip file of the entire repository. To do this, find the “Download ZIP” button on the repository, then save to your local drive. This won’t be tied to the repository at all if you were to make any changes.
Want to propose additions and changes?
If you would like to propose any additions or changes to the main branch, you must fork the repository, and then make a pull request. To learn more about this, please review https://help.github.com/articles/fork-a-repo/. Follow the steps in that tutorial, using the sample repository, to learn how to do your first fork.
If you choose “Clone in Desktop,” this will create a fork for you and try to open the repository in your GitHub for Windows/Linux desktop application. If you don’t have that installed, you should be redirected to a location to install the application. Another option is to simply “Fork” this repository, found in the upper right. Forking the repository will just make a personal copy of the repository for you in your own account. When you want to make changes, you would need to commit any changes locally, and then create a pull request to alert Rocket Software that you would like to merge your code into the master branch.