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 :)

    188 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

      24 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

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

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

          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

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

            Would love an API for programmatically searching for content.

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

              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

                1 comment  ·  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.

                5 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 →
                • 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 :)

                  5 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 →
                  • 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 →
                    • Make the documentation printer-friendly.

                      The documentation is not currently printer-friendly. While the content can be printed, there is a lot of baggage at the beginning as well as loads of empty pages at the end.

                      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

                        2 comments  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →

                        Thanks for the feedback! Please share an example and the browser you are using. We are not able to reproduce the issue.

                      • Enable a user to have her/his own area to collect articles, save reading sessions etc

                        When I go to docs.microsoft.com I'm usually looking at similar and related things every time. Like for instance I might be looking for reference information on XAML and C++ examples or other very specific areas of interest, and that is what I do every time.

                        It would be nice to have your own area that saves recently read articles, save reading sessions and that present related articles that might be of interest to me specifically.

                        2 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 →
                        • https://docs.microsoft.com/en-us/dotnet/standard/io/

                          Provided content is GREAT! I am a professor in secondary technical school teaching programming... Can I use content from "doc.micrsoft.com" site for crating materials for my pupils? (On MSDN, there was a note: "Accredited educational institutions, such as K-12 schools, universities, and private or public colleges may download and reproduce Microsoft Content for distribution in the classroom for educational purposes." Here in "Terms of Use" says: "for your personal and non-commercial use". I am writing this question here because I don't know how to/who to contact to answer my BIG question. THANK'S A LOOT!

                          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 →
                          • Please create a search box on the blog page of power bi

                            The Power BI page needs to be able to let me search the entire blog. The current search box is only on the documentation page.

                            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

                              1 comment  ·  User Experience Issue  ·  Flag idea as inappropriate…  ·  Admin →
                            • List Unsupported .NET Versions

                              The new documentation browser added an "Applies to" section at the bottom, which lists each of the supported versions of .NET.

                              It would be EXTREMELY useful if the documentation listed which .NET versions APIs are unsupported in.

                              If you're writing .NET code that could be built with a range of .NET versions (i.e., libraries), then there is no reasonable way to check which versions the APIs you're using will be supported on.

                              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 →

                                Thank you for the feedback! “Applies To” covers the supported versions of the platform. If the platform release is not listed there, it likely does not support the API. Do you have any examples of pages where that was not accurate?

                                Den Delimarsky
                                PM, docs.microsoft.com

                              • Problem whith revers translater using on the first Headline of a Page

                                There is a "Reverse Translater German -> English" für automatic from english to german translated pages available ("Sie können den englischsprachigen Text in einem Popupfenster anzeigen, indem Sie den Mauszeiger auf den Text platzieren.´"). The work fine. But not at the Headline. The Headline is top of the page. The reverse Translation Above of the translated Text. For the first Headline this is not posible, so the reverse Translation is not visible. The reverse Translation of the first Headline should shown after the original Text.

                                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 →
                                • Make avatar icons for authors and contributors bigger

                                  Avatar icon for authors and contributors are too small. It was possible before to recognize avatars.

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

                                    Sehr informative und gut strukturierte Seite. Nur sind in der deutschen Übersetzung einige Fehler. Zum Bsp. ist die Rede von C##. Habe direkt gesucht ob es die Sprache gibt. Musste mit einem Schmunzeln feststellen, dass es ein Schreibfehler war.

                                    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 →
                                    • please add a next section button on the end of page

                                      请在页面的末端加一个下一节的按钮。

                                      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 →
                                      • more images to explain the process on each step

                                        not able to understand exact meaning of doc

                                        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 →
                                        • MS Help Viewer - Getting Started With C# subsection link not open

                                          In Microsoft Help Viewer offline book guide for C# section under Getting Started with C# category following first link not opening:

                                          Building a C# Hello World application with .NET Core in Visual Studio 2017

                                          Saying "Cannot find requested topic on your computer"

                                          Others section opening correctly.

                                          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

                                            1 comment  ·  Bug  ·  Flag idea as inappropriate…  ·  Admin →
                                          • Don't see your idea?

                                          Feedback and Knowledge Base