January 12th, 2017

Improving the NuGet documentation experience on docs.microsoft.com

Karan Nandwani
Program Manager

In late 2016, we started on the journey of improving the docs experience for NuGet with the revamped docs experience. Continuing that journey, today we are announcing the move to docs.microsoft.com/nuget. Given how NuGet has grown to become an integral part of the Visual Studio and .NET ecosystems, this move furthers the integration by providing a seamless experience to navigate documentation across .NET, Visual Studio and NuGet.

This move also brings several improvements such as:

  • Responsive design supporting multiple form-factors such as mobile devices, tablets, and PCs.
  • Adding side-notes for articles
  • Adding comments as well as subscribing to them
  • Viewing estimated reading time and understanding the freshness of the content

Will my existing references to documentation break?

Existing references should continue to work. We have updated the old docs with permanent redirects which will redirect you to the new page. If you find a broken reference, please open an issue on our GitHub repo and we’ll work to get it fixed.

How can I contribute?

Every page that allows contribution has an “Edit” button at the top right which navigates to the md file. Feel free to make changes and submit a PR from your branch. The NuGet team will review the changes and work with you to get it merged.

If you would like to raise a request for new docs or changes to existing docs, feel free to open a new issue.

We want to hear your feedback!

We want NuGet to meet the evolving needs of our community. If you would like to share your pain points, and your current or future needs, hit us up at feedback@nuget.org. You can also leave a comment below, and as always, if you run into any issues or have an idea, open an issue on GitHub.

Author

Karan Nandwani
Program Manager

Karan drives product management for the NuGet team at Microsoft. His team owns the NuGet client experience (nuget.exe, dotnet.exe, and the NuGet package manager for Visual Studio) as well as the NuGet.org package repository. He works closely with .NET and Visual Studio to deliver seamless end-to-end experiences. He is always available to chat about feature asks, pain-points, and how NuGet can help meet your evolving needs.

0 comments

Discussion are closed.