Easy Spec Reviews with GitHub & Bots

As a Program Manager, part of my job is to write technical specification documents. Our team recently switched to using our very own system (yes, we use the docs.microsoft.com infrastructure internally too) to write technical specs – content is on GitHub and Markdown-based. As part of that came the question – how do we aggregate comments when people review them?

Continue reading Easy Spec Reviews with GitHub & Bots

How We Build Documentation for .NET-based SDKs

If you are following the news around our new technical documentation experience, you probably know that last week we revamped our managed reference experience and launched the .NET API Browser. In today’s post, I thought I would go into the nitty-gritty of the process and talk about how exactly we generate reference documentation for .NET Framework and related managed SDKs.

Continue reading How We Build Documentation for .NET-based SDKs

Tip of The Day: View Photos with Windows Photo Viewer on Windows 10

With the release of Windows 10, all photos are now opened by default with the help of the Photos app. I like the Photos app, but I also enjoy the UI of the traditional Windows Photo Viewer.

Continue reading Tip of The Day: View Photos with Windows Photo Viewer on Windows 10

Binding Dynamic Build Definitions to GitHub Repos

As part of the project that I am working on, I need to make sure that I allow the user to specify what GitHub repository they want to bind to their Visual Studio Team Services build definitions. I am using the Microsoft.TeamFoundationServer.Client library for that, but no matter what I tried, the repository just did not show up.

Continue reading Binding Dynamic Build Definitions to GitHub Repos

On Importance of Documentation

This October marks a year since my switch from working on client software to working on the unified Microsoft documentation experience. Throughout the past year I had to learn a tremendous amount of absolutely new (to me, at least) things that totally changed my perception of what the importance of documentation is.

Continue reading On Importance of Documentation