Introducing our new Roslyn-powered Samples Browser

by Gael Fraiteur on 08 Mar 2016

When developers first discover PostSharp and decide to give it a try, one of the most frequent feedback we hear is the lack of samples that they could just download, compile and study. After years of ignoring the problem and focusing on building (look, we don’t have a single full-time marketing person in the company!), we’ve finally decided to give it the priority it deserves.

GitHub seemed to be the right way to share the source code, but let’s face it: GitHub’s source code browser could be better. The formatting is nice and colorful but GitHub does not link references to declarations and documentation.

So we looked at another solution to complete the gaps in GitHub code browser, and this thing immediately came to our mind: the Roslyn-powered .NET Reference Source Browser which has been open-sourced. That seemed the perfect solution, but some features would potentially drag the reader’s attention away from PostSharp to implementation details of the .NET Framework, which was not our objective here. So we commented out a few lines of code in the sample browser and linked the samples source code to our documentation instead of to the .NET Framework source code. We also added support for Markdown.

Today, we’re proud to release the best sample code browser in industry! Try it by yourself on https://samples.postsharp.net/. Of course, we’re still hosting the source code on GitHub and you can download or clone all samples from https://github.com/postsharp/PostSharp.Samples.

What do you think? Do you agree we have the best sample code browser in industry? If not, which sample browser do you prefer and why?

Happy PostSharping!

-gael