Site Feedback
-
Make the system open source
..to help improving other documentations as well :)
113 votesThank you for your feedback! We are currently assessing the possibility of releasing the underlying system as open-source. In the mean-time, you can download DocFX (https://dotnet.github.io/docfx/) to leverage the core technology behind docs.microsoft.com.
-
RSS Feed
This is a nice format but losing RSS Feed notifications is a drawback.
32 votesThank you for the feedback! We are currently looking into a way to enable users to follow content changes.
-
Link to reference source code
Add a link to reference source code to easily view source of current class/method
25 votesThank you for the feedback, we are investigating this!
Den Delimarsky
PM, docs.microsoft.com -
Dramatically improve site performance
Performance is very poor. E.g. for a page picked at random you are in the bottom 50% of sites in terms of speed according the pingdom speed test. See e.g. https://tools.pingdom.com/#!/dYpCmZ/https://docs.microsoft.com/en-us/uwp/api/windows.ui.input.spatial.spatialp
You take 48 requests (including 21 scripts!) and 1.22MB to show some a site where the valuable content is text.. Speed is critical for technical docs, since you tend to click around so much.
22 votesThanks for the feedback, we are currently looking into how we can improve the performance.
-
Offer offline documentation in more formats
While the offline viewing option is great, PDF's "baked in" page format makes reading on mobile devices very cumbersome. I suggest offering downloads in open ePub format for easy reading on mobile devices -- allowing for text reflow, text and margin adjustment, color themes, etc.
15 votes -
Use the learning path approach for more documentation
On the documentation organization\navigation topic, one way of doing the documentation that is used for some product in Azure is the learning map\path (example: https://azure.microsoft.com/en-us/documentation/learning-pat...). I just LOVE that approach, it's visual, it's clear, you know where you are and where you are going, it's task oriented: it's perfect.
15 votesThank you for the feedback! We are currently looking into the possibility of introducing learning paths on docs.
-
Support searching for parts of API names
Support searching for parts of API names - e.g. index camel cased word parts.
Currently, there are no Results for "NullOrEmpty" - which is just a full part of "IsNullOrEmpty".
It would also be helpful to fuzzily match up names (better than no results): e.g. "isnowhi" should include "String.IsNullOrWhitespace" in the results (ranked below a possible "IsNowhereIncluded" method).
12 votesThank you for your feedback! We are currently investigating this.
-
When browsing .Net standard, show the minimum version a namespace is introduced
It would be great to be able to see the first/minimum version that a namespace is introduced. This way, if you are browsing and realize that you really only need .Net Standard 1.3 instead of 1.6, for example, you can see that quickly without having to flip back and forth. Alternatively, having a feature comparison chart where 2+ .Net versions are selected and their namespaces are compared would serve the same purpose.
12 votesThank you for the feedback, we are assessing how this can be done.
Den Delimarsky
PM, docs.microsoft.com -
Review the text layout design
Whilst I think the new layout of the site is much cleaner, and much easier to read & follow content, I do think there should be a review of the approach to using so much 'white space' either side of the content.
For example, I am using the new site, to review a document on my PC. I have the browser window snapped to one side, whilst I walk through the actual settings on another window (snapped to the other half of my screen).
The 'docs' content - on the left hand side - is now limited to two-thirds of…11 votes -
Search API
Would love an API for programmatically searching for content.
10 votesThank you for your feedback! We are currently assessing the possibility to implement a public search API.
-
Display extension methods in API reference for a class
For example, in the existing MSDN documentation for IEnumerable<T>, we also see all of the extension methods that are defined for that type:
https://msdn.microsoft.com/en-us/library/9eekhta0(v=vs.110).aspx
In the new .NET API Browser, the IEnumerable<T> reference only lists the GetEnumerator() method. None of the documentation for IEnumerable<T> says anything about the presence of these extension methods or even links to System.Linq.Enumerable.
https://docs.microsoft.com/en-us/dotnet/api/System.Collections.Generic.IEnumerable-1
9 votesThank you for the feedback, we are investigating.
Den Delimarsky
PM, docs.microsoft.com -
Link to Entity Framework Core docs SOMEwhere on or near the docs.microsoft.com home page
There is no obvious location for it when you arrive on the home page. Neither the .NET Core nor ASP.NET Core pages have links to it that I found. Maybe there is a link three or four levels deep, but it is ridiculous to make someone click around that much to find it.
9 votesThanks for the feedback, we are investigating.
-
Display the date using the browser's locale
The date in article headers is great, but can it please be localised (e.g. dd/mm/yyyy in the UK) rather than assuming US-format dates?
8 votes -
Wider navigation pane
Please make the (left) navigation pane a little wider on wide screen monitors (1600px). It will increase readability in both the navigation pane (particularly in case of indented content) and main content.
8 votesThis is currently under review. Thank you for your feedback!
-
Add support for ASP.NET Core
Add support for ASP.NET Core Api reference
Also Identity Core and EF Core6 votes -
expose an end point so third party (IDE etc) can hook into docs
Based on keywords, expose articles in either xml or json so third party apps can integrate documentation.
6 votesThanks for the feedback, this feature is currently under review.
-
Please provide à custom scrollbar for dark theme
The native scrollbar may be light and high contrast with the background. It's quite disturbing.
5 votes -
Use short well know type names
Right now Monitor.Wait is displayed as:
Monitor.Wait(System.Object,System.Int32,System.Boolean)
Much easier to read version would be:
Monitor.Wait(object, int, bool)5 votes -
MSDN software version suggestion from user preferences
From a developer point of view, when searching some information over a software topic, it is, typically, over a specific version. MSDN result search point to the most recent version of that software which could lead to misinformation, e.g. deprecated functionalities or even new functionalities not currently supported. With a user preference about a specific software, it could lead to a more accurate and faster search result.
5 votes -
Section headers (Parameters, Constructors, etc) need Collapse All
Every member has a collapse button, but member groups don't have a Collapse All.
5 votes
- Don't see your idea?