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. 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.

    18 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 →
    • Make the system open source

      ..to help improving other documentations as well :)

      126 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

        10 comments  ·  Flag idea as inappropriate…  ·  Admin →
      • RSS Feed

        This is a nice format but losing RSS Feed notifications is a drawback.

        38 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

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

          Would love an API for programmatically searching for content.

          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  ·  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

            34 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 →
            • 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.

              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

                6 comments  ·  Flag idea as inappropriate…  ·  Admin →
              • Search Breadcrumbs

                Expose the existing breadcrumbs to search engines:
                https://developers.google.com/search/docs/data-types/breadcrumbs
                https://www.bing.com/webmaster/help/markup-breadcrumbs-72419f3f

                This clarifies exactly what each page relates to directly from search results, without relying on the URL (which is often truncated) or the page's title.

                4 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 →
                • Inscrease GitHub avatar resolution in azure-docs

                  64 is so much better than 16 pixels.
                  See this: http://i.imgur.com/Ach0AvG.png

                  Currently it looks really bad on any high DPI display if you zoom in just a tad. The community will also love you more, since they're now even sharper :)

                  4 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 →
                  • 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.

                    10 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  ·  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).

                      16 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 →
                      • 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.

                        18 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 →
                        • Won't search short class names

                          Searching for the GC class doesn't return any results E.g. https://docs.microsoft.com/en-us/dotnet/api/?term=GC If I search https://docs.microsoft.com/en-us/dotnet/api/?term=System.GC does though. This feels closely related to the "Support searching for parts of API names" request though.

                          3 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

                            4 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 →
                            • 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

                              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 →
                              • 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.

                                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

                                  3 comments  ·  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.

                                  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

                                    1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                                  • Make it possible to Share with linkedin

                                    Linkedin sharing. You own linkedin for God sake.

                                    3 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 →
                                    • 1 vote
                                      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  ·  Bug  ·  Flag idea as inappropriate…  ·  Admin →
                                      • 1 vote
                                        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 →
                                        • 1 vote
                                          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 →
                                          ← Previous 1
                                          • Don't see your idea?

                                          Feedback and Knowledge Base