Site Feedback

How can we make our site better?

(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  1. Make the system open source

    ..to help improving other documentations as well :)

    159 votes
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)

      We’ll send you updates on this idea

      15 comments  ·  Flag idea as inappropriate…  ·  Admin →
    • Link to reference source code

      Add a link to reference source code to easily view source of current class/method

      48 votes
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        I agree to the terms of service
        Signed in as (Sign out)

        We’ll send you updates on this idea

        2 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
      • 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).

        29 votes
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          I agree to the terms of service
          Signed in as (Sign out)

          We’ll send you updates on this idea

          1 comment  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
        • 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.

          24 votes
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            I agree to the terms of service
            Signed in as (Sign out)

            We’ll send you updates on this idea

            2 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
          • 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.

            22 votes
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              I agree to the terms of service
              Signed in as (Sign out)

              We’ll send you updates on this idea

              4 comments  ·  Flag idea as inappropriate…  ·  Admin →
            • 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.

              20 votes
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                I agree to the terms of service
                Signed in as (Sign out)

                We’ll send you updates on this idea

                2 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
              • Search API

                Would love an API for programmatically searching for content.

                15 votes
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  I agree to the terms of service
                  Signed in as (Sign out)

                  We’ll send you updates on this idea

                  0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                • Bring back the "Version information" section in documentation pages

                  MSDN docs have a "Version information" section which says in which version a type or member was introduced. This is important information and should be included on the new site.

                  12 votes
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    I agree to the terms of service
                    Signed in as (Sign out)

                    We’ll send you updates on this idea

                    0 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                  • 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.

                    11 votes
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      I agree to the terms of service
                      Signed in as (Sign out)

                      We’ll send you updates on this idea

                      1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                    • Highlight whichever rightNav ## H2 is currently at top of browser display.

                      Some articles are longer than most, and have more ## H2 sections than most (and long articles are good). When I vertically scroll further into the article, I often can no longer see which H2 section the scroll is in. Comprehending the article becomes problematic, like a floor map that lacks a "You Are Here" indicator. Therefore...
                      Please auto-highlight (color, bold) whichever rightNav H2 link corresponds to the current vertical scroll location. Thanks. GeneMi 2017/11/03

                      11 votes
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        I agree to the terms of service
                        Signed in as (Sign out)

                        We’ll send you updates on this idea

                        0 comments  ·  User Experience Issue  ·  Flag idea as inappropriate…  ·  Admin →
                      • 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?

                        9 votes
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          I agree to the terms of service
                          Signed in as (Sign out)

                          We’ll send you updates on this idea

                          4 comments  ·  Flag idea as inappropriate…  ·  Admin →
                        • 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)

                          9 votes
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            I agree to the terms of service
                            Signed in as (Sign out)

                            We’ll send you updates on this idea

                            1 comment  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                          • Fix D2D documentation

                            D2D should be plain obvious. Tons of interfaces interfaces are missing from content tree and offline help.

                            Example:
                            – browse the content tree (Desktop technologies /Graphics and Gaming /DirectX /Direct2D /API /Interfaces)
                            – notice a ton of interfaces are missing in the first place (mostly the original interfaces, but now that I look closely, ID2D1Bitmap1 is missing, too; its a mess …)
                            – click ID2D1DeviceContext1 => available offline
                            – follow the link to ID2D1DeviceContext => missing, resolved online
                            – if you look for ID2D1DeviceContext in the index you can get to some of the methods (available offline), but not to…

                            8 votes
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              I agree to the terms of service
                              Signed in as (Sign out)

                              We’ll send you updates on this idea

                              0 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                            • Allow flagging of comments for spam

                              There are lots of comments on the site that, whilst not harmful can be dangerous.

                              Take this page for instance:
                              https://docs.microsoft.com/en-gb/dotnet/articles/visual-basic/

                              There are a couple of comments by a user attempting to submit XSS content to the page.

                              There should be an option to flag such comments as spam.

                              Thanks, Dan

                              8 votes
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                I agree to the terms of service
                                Signed in as (Sign out)

                                We’ll send you updates on this idea

                                0 comments  ·  Security Issue  ·  Flag idea as inappropriate…  ·  Admin →
                              • Give me the option to hide navigation panes

                                The current doc format has 2 navigation panes on the sides and the content in the center. I use sometime the nav. pane on the left but never the one on the right so i'd like the option to hide it since it makes the center section (with the core content) too narrow.
                                The ideal would be the option to hide both so that if user want he can focus just on the content and have all the space dedicated to it. Thanks

                                8 votes
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  I agree to the terms of service
                                  Signed in as (Sign out)

                                  We’ll send you updates on this idea

                                  2 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                                • Search needs to have filtering options

                                  Finding the right article is much too hard on docs.microsoft.com. For example, searching for Server Manager (in Windows Server 2016) brings up 36 000+ results, with the first page all about SQL Server. It should now be possible to filter the results based on product so that I get to Win 2016, or whatever.

                                  7 votes
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    I agree to the terms of service
                                    Signed in as (Sign out)

                                    We’ll send you updates on this idea

                                    0 comments  ·  User Experience Issue  ·  Flag idea as inappropriate…  ·  Admin →
                                  • Please provide a class summary table like MSDN had

                                    Example:
                                    https://docs.microsoft.com/en-us/uwp/api/Windows.UI.Xaml.Controls.Grid
                                    All the inherited members are just a giant unformatted sea of hyperlinks. And for everything implemented by the class, it's a giant scrolling page trying to find anything. Old MSDN had a nicely formatted summary table listing all of the class's members, properties, and events, with hyperlinks and a brief description of the member. It's *incredibly* difficult to now to get an "at a glance" view of what a class actually does.

                                    7 votes
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      I agree to the terms of service
                                      Signed in as (Sign out)

                                      We’ll send you updates on this idea

                                      1 comment  ·  User Experience Issue  ·  Flag idea as inappropriate…  ·  Admin →
                                    • Add a "how to enable long path support with nuget and .NET 4.6.2" section

                                      Add a section in the documentation that explains how to enable long path support with nuget.exe commandline tool and .net 4.6.2 - the idea is to add a nuget.exe.config file to same directory as user has nuget.exe located and then add the following to the nuget.exe.config (requires .NET 4.6.2 installed on machine running nuget.exe):

                                      <?xml version="1.0" encoding="utf-8" ?>
                                      <configuration>
                                      <startup>
                                      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2" />
                                      </startup>
                                      <runtime>
                                      <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false;Switch.System.IO.BlockLongPaths=false" />
                                      </runtime>
                                      </configuration>

                                      6 votes
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        I agree to the terms of service
                                        Signed in as (Sign out)

                                        We’ll send you updates on this idea

                                        1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                                      • Please provide à custom scrollbar for dark theme

                                        The native scrollbar may be light and high contrast with the background. It's quite disturbing.

                                        6 votes
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          I agree to the terms of service
                                          Signed in as (Sign out)

                                          We’ll send you updates on this idea

                                          0 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                                        • Section headers (Parameters, Constructors, etc) need Collapse All

                                          Every member has a collapse button, but member groups don't have a Collapse All.

                                          6 votes
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            I agree to the terms of service
                                            Signed in as (Sign out)

                                            We’ll send you updates on this idea

                                            1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                                          ← Previous 1 3 4 5 10 11
                                          • Don't see your idea?

                                          Feedback and Knowledge Base