Panels vs. Context: A Tale of Two Visual Studios and a Practical Explanation of the Value of CodeLens

If you have Visual Studio 2013 Ultimate, you know CodeLens is amazing.  If you don’t know what CodeLens is, I hope this helps.  I have a lot of customers who ask me about CodeLens, what it is, and how valuable I think it is for an organization.  Here’s my response.

It’s really a tale of two Visual Studios, if you think about.

A Visual Studio Full of Panels

Let’s say you’re looking at a code file, specifically a method.  Your Visual Studio environment may look like this:

I’m looking at the second Create method (the one that takes a Customer).  If I want to know where this method may be referenced, I can “Find All References”, either by selecting it from the context menu, or using Shift + F12. Now I have this:

Great!  Now, if I decide to change this code, will it will work?  Will my tests still work?  In order for me to figure that out, I need open my Test Explorer window.

Which gives me a slightly more cluttered VS environment:

(Now I can see my tests, but I still need to try and identify which tests actually exercise my method.)

Another great point of context to have is knowing if I’m looking at the latest version of my code.  I’d hate to make changes to an out-of-date version and grant myself a merge condition.  So next I need to see the history of the file.

Cluttering my environment even more (because I don’t want to take my eyes of my code, I need to snap it somewhere else), I get this:

Okay, time out.  

Yes, this looks pretty cluttered, but I can organize my panels better, right?  I can move some panels to a second monitor if I want, right?  Right on both counts.  By doing so, I can get a multi-faceted view of the code I’m looking at.  However, what if I start looking at another method, or another file?  The “context” of those other panels don’t follow what I’m doing.  Therefore, if I open the EmployeesController.cs file, my “views” are out of sync!

That’s not fun.

A Visual Studio Full of Context

So all of the above illustrates two main benefits of something like CodeLens.  CodeLens inserts easy, powerful, at-a-glance context for the code your looking at.  If it’s not turned on, do so in Options:

While you’re there, look at all the information it’s going to give you!

Once you’ve enabled CodeLens, let’s reset to the top of our scenario and see what we have:

Notice an “overlay” line of text above each method.  That’s CodeLens in action. Each piece of information is called a CodeLens Indicator, and provides specific contextual information about the code you’re looking at.  Let’s look more closely.

References

References shows you exactly that – references to this method of code.  Click on that indicator and you can see and do some terrific things:

It shows you the references to this method, where those references are, and even allows you to display those references on a Code Map:

Tests

As you can imagine, this shows you tests for this method.  This is extremely helpful in understanding the viability of a code change.  This indicator lets you view the tests for this method, interrogate them, as well as run them.

As an example, if I double-click the failing test, it will open the test for me.  In that file, CodeLens will inform me of the error:

Dramatic pause: This CodeLens indicator is tremendously valuable in a TDD (Test Driven Development). Imagine sitting your test file and code file side-by-side, turning on “Run Tests After Build”, and using the CodeLens indicator to get immediate feedback about your progress.

Authors

This indicator gives you very similar information as the next one, but list the authors of this method for at-a-glance context.  Note that the latest author is the one noted in the CodeLens overlay.  Clicking on this indicator provides several options, which I’ll explain in the next section.

Changes

The Changes indicator tells you information about the history of the file at it exists in TFS, specifically Changesets.  First, the overlay tells you how many recent changes there are to this method in the current working branch.  Second, if you click on the indicator you’ll see there are several valuable actions you can take right from that context:

What are we looking at?

• Recent check-in history of the file, including Changeset ID, Branch, Changeset comments, Changeset author, and Date/time.
• Status of my file compared to history (notice the blue “Local Version” tag telling me that my code is 1 version behind current).
• Branch icons tell me where each change came from (current/parent/child/peer branch, farther branch, or merge from parent/child/unrelated (baseless)).

Right-clicking on a version of the file gives you additional options:

• I can compare my working/local version against the selected version
• I can open the full details of the Changeset
• I can track the Changeset visually
• I can get a specific version of the file
• I can even email the author of that version of the file
• (Not shown) If I’m using Lync, I can also collaborate with the author via IM, video, etc.

This is a heck of a lot easier way to understand the churn or velocity of this code.

Incoming Changes

The Incoming Changes indicator was added in 2013 Update 2, and gives you a heads up about changes occurring in other branches by other developers.  Clicking on it gives you information like:

Selecting the Changeset gives you the same options as the Authors and Changes indicators.

This indicator has a strong moral for anyone who’s ever been burned by having to merge a bunch of stuff as part of a forward or reverse integration exercise:  If you see an incoming change, check in first!

Work Items (Bugs, Work Items, Code Reviews)

I’m lumping these last indicators together because they are effectively filtered views of the same larger content: work items.  Each of these indicators give you information about work items linked to the code in TFS.

Knowing if/when there were code reviews performed, tasks or bugs linked, etc., provides fantastic insight about how the code came to be.  It answers the “how” and “why” of the code’s current incarnation.

 

A couple final notes:

• The indicators are cached so they don’t put unnecessary load on your machine.  As such they are scheduled to refresh at specific intervals.  If you don’t want to wait, you can refresh the indicators yourself by right-clicking the indicators and choosing “Refresh CodeLens Team Indicators”

• There is an additional CodeLens indicator in the Visual Studio Gallery – the Code Health Indicator. It gives method maintainability numbers so you can see how your changes are affecting the overall maintainability of your code.
• You can dock the CodeLens indicators as well – just know that if they dock, they act like other panels and will be static.  This means you’ll have to refresh them manually (this probably applies most to the References indicator).
• If you want to adjust the font colors and sizes (perhaps to save screen real estate), you can do so in Tools –> Options –> Fonts and Colors.  Choose “Show settings for” and set it to “CodeLens”.

 

I hope you find this helpful!

Comments

• Anonymous
  June 19, 2014
  Dear Sir, Thanks for nice example of CodeLans while looking your screen shot can you give me idea about a simple n tier application using asp.net mvc 5

• Anonymous
  June 19, 2014
  @Shakti - I'm not exactly sure what you're asking for, but specific to MVC 5, you can find examples here: www.asp.net/.../aspnet-mvc

• Anonymous
  June 26, 2014
  Would be nice if it worked with VSO.

• Anonymous
  June 27, 2014
  @Rob: If are using or plan to use Git repositories (for instance hosted in VSO), Visual Studio 2013 Update 3 brings the Code Lens team indicators for Git

• Anonymous
  June 28, 2014
  Great feature, agreed, but one that hardly any developers will ever use, because it's only available in VS Ultimate, which costs over $13000, with renewals coming in at more than $4000 pa. Most developers use VS Pro and they're not going to shell out this kind of money to get code lens. So we're still left with a tale of two Visual Studios.

• Anonymous
  June 29, 2014
  The comment has been removed

• Anonymous
  June 29, 2014
  @Paul, $13K would be cheap! For Australia it's $AU21,202 (which is ridiculous when you consider the current exchange rate equivalent is only $AU14,130 - that's a $7000 markup just for being in Australia)

• Anonymous
  June 29, 2014
  @ Paul 29 Jun 2014 Indeed, I was searching in my VS Pro and couldn't find it. My colleague with Premium (MSDN) couldn't find it either. So this is a nice example of an expensive feature which will be axed because nobody uses it. Xamarin anyone?

• Anonymous
  June 29, 2014
  @All - You're certainly not the only ones who would like to see CodeLens more widely available (i.e. outside of the Ultimate SKU)!  It is often the first question I'm asked when talking about new features introduced at the Ultimate level.  Indeed, VS Ultimate is a pretty specialized (and of course more pricey) SKU. In fact, this has already been requested via UserVoice - visualstudio.uservoice.com/.../4150271-make-codelens-available-outside-of-ultimate There you can read a reply from the product team concerning their current direction with CodeLens. Thanks, Steve

• Anonymous
  June 30, 2014
  But my wife is more beautiful than yours!

• Anonymous
  July 02, 2014
  Go get BizSpark! create a company for a few dollars, and pay the $100 enrollment fee (for 3 years) and you get VS Ultimate for free (as well as everything elso Microsoft make/sell) - SORTED!!

• Anonymous
  July 30, 2014
  I do a lot of work for Investment Banks and even they don't give developers more than Pro. Lets face it, this is an MS internal feature! Great work guys, now go fix the long list of outstanding bugs in the C++ compiler.

• Anonymous
  September 06, 2014
  Nice article but Ultimate is just too expensive and this isn't really going to convince the beancounters... I've worked for a number of startups and SME's and without exception the only one to provide VS Ultimate was a startup with Bizspark. Every other employer thought VS Professional was enough and to be 100% honest I have not seen any other feature (than CodeLens) in the mangled 2012, just slightly better 2013 and (i'm still undecided) 2014 what would warrant day-to-day use.. VS 2010 and TFS 2010 contain every feature I need, and at least one was completely removed from later versions. Although I have VS Professional with MSDN the only additional feature I require from later versions is Blend. CodeLens would be nice if it didn't add too much bloat. I know developers that have dumped VS and .NET and moved to Java/Eclipse etc, MS would retain more devs on their platform if they spent more time fixing memory leaks / reducing overheads than working on features and/or new versions with new bugs that  most companies and developers wont see the value or benefit of.

• Anonymous
  September 25, 2014
  Pointless, we are just not going to spend the cash for this.  Instead we push that money to tools like ReSharper and Telerik UI suites.  

• Anonymous
  October 03, 2014
  The comment has been removed