January 2018 Release Notes
This post was written by Dan Fernandez, Senior Director in the Cloud + Enterprise Division.
Our team is dedicated to continuously deliver features that delight and excite our users, as well ensure they can always find the relevant documentation and samples. In this post, we document some of the changes that we've made to docs.microsoft.com in the past month, rolling into 2018.
New Documentation Releases
Working with our partners, we launched several new documentation resources on our site, continuing our commitment to make all technical documentation for Microsoft products available on docs.microsoft.com:
- Microsoft Style Guide - make sure to read our blog post announcing the guide.
- Azure PowerShell 5.2.0
- Azure Consumption REST Reference 2018-01-31
In addition to the above, we are always working to keep our API documentation up-to-date for all platforms and products, as well as expand the internationalization efforts - updates to those are rolled out on a daily basis. And of course, we continue the migration of content from MSDN to docs.microsoft.com.
We want to make sure that as you read our articles, your experience is as smooth as possible. As we listen to customer feedback on Twitter and through a multitude of other channels, we've identified areas where we can deliver some enhancements. This is just a short snapshot of them.
It's now easier than ever for you to link directly to specific parts of an article - simply hover over a heading and click on the link icon:
You can also right-click on the icon to copy the URL to that section, or copy the URL from the address bar once you click on the link icon.
In addition to anchors, now it's very easy to tell which part of the document you are reading, with the help of the in-article position indicator:
As you move through the article, the table of contents on the right will show the change in position within the article. You can click on any of the links to jump directly to the part of the document that is most interesting to you.
GitHub Issues for Article Feedback
We recently announced the transition to GitHub issues for article feedback. We believe it will help us balance a transparent approach to tracking and resolving documentation issues with user convenience and ease of use.
New Cloud Developer Advocate Site
You've likely heard of our crew of cloud developer advocates - they write, speak and dream in code, and are always creating new content for you to learn about our technical offerings. We thought we would make it easier for users to find and follow advocates around the world, so we launched a brand-new cloud developer advocate site
You can now see at-a-glance what the team is doing, who is the relevant industry expert, where they can be found and what is the best way to reach them. The site is powered by the same infrastructure as docs.microsoft.com.
There are more things planned for this year, and we are excited for you to see them!
In the meantime, make sure to follow our blog and Twitter account for the latest updates. If you have any feature suggestions or ideas, don't forget to create a new item on UserVoice and we will follow-up with you shortly!