.NET Sample Code on GitHub
— Immo Landwerth (@terrajobst) September 16, 2014
Why did we move to GitHub?
The reasons we decided to move the samples to GitHub is as follows:
- We want to be where our community is
- GitHub offers an awesome browsing experience
- GitHub enables conceptual documentation to be located with sample code
- We want to be able to accept contributions
Let me take them one by one.
We want to be where our community is
The majority of the .NET community is on GitHub these days. Our principle is, and has been, to go where our customers are, rather than asking them to move somewhere else, say, MSDN Code Gallery.
GitHub offers an awesome browsing experience
The nice thing with GitHub is that it allows us to link to parts of the samples. For example, in SIMD we can point you to a specific line of code that shows how you can use the SIMD types to vectorize Mandelbrot:
GitHub enables conceptual documentation to be located with sample code
Sample code usually comes with at least a
README file that explains how to get started. However, depending on the component the sample is for we may want to include a more comprehensive documentation. While sample code and documentation aren’t a replacement for MSDN, but we think they can provide a starting point for what will eventually become the official documentation.
We want to be able to accept contributions
Publishing our samples to GitHub streamlines any updates. Team members can easily fix typos or clarify parts of the documentation using the web front-end.
But more importantly, it also enables you to provide sample code or propose changes. Many of you have asked about this for years — it’s finally a reality!
What about Visual Studio Online?
We love and use VSO for our private projects internally and think it’s the best one-stop-shop for cloud dev services (including full support for Git repos and unlimited private projects for free). It just doesn’t support public projects today.
Please take a look at the new sample site on GitHub and let us know if you have any feedback!