General Site Feedback

Welcome!

For years customers have told us to go beyond walls of text with feature-level content and help them implement solutions to their business problems. We knew that the content we delivered and the platform we built must make it easy for customers to learn and deploy solutions.

We realized that to get the overall experience right we needed to start from scratch; from this effort comes https://docs.microsoft.com – a new hope for documentation at Microsoft.

Learn More

This site is the most effective place to share your feature requests and ideas for improving docs.microsoft.com. The engineering and management teams regularly review the ideas and incorporate them into planning discussions.

I suggest you ...

(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. Toggling between code sample langueages

    Like on MSDN - you see code only in one language but can click to see another.

    With long code, you have to scroll a lot. When you stop in the middle it takes a sec to recognize what language this is.

    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

      2 comments  ·  User Experience Issue  ·  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.

      17 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

        5 comments  ·  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 →
        • 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

          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

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

            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  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
            • Don't pop up an animated twitter logo every time I select text

              I often visit an API documentation page and select some text to copy into my code editor. Now with short selections, the web page renders a slow, distracting animation with a bouncing twitter logo and a facebook logo. I don't understand why you think I want to tweet your documentation, ever. And even if I were to ever want to do this, I'll use copy + paste to get it done; I don't need a giant button in the middle of the screen.

              Please delete the popups. No popups for any reason. Especially not animated bouncing twitter logos.

              Example URL: …

              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 →
              • Fix your f^king website.

                As usual when following a link (https://msdn.microsoft.com/en-us/library/ms141747.aspx) to that half-assed company (Microsoft):
                The page you requested could not be found

                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  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                  • Improve site navigation

                    The docs site doesn't feel like a coherent whole. There are too many tabs and menus and many navigate out to different websites. Plus it's always difficult to know how to get back to the root of the site. E.g. i've been clicking around the Docs on Microsoft Edge and now i want to get back to the .NET Core documentation. How do i get there? The Microsoft logo in the top left takes me to Microsoft.com, not docs.microsoft.com. The only way i can see is to retype the URL or click back button maybe a dozen or more times.

                    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 →
                    • The translation of documents are very bad. For example: Chinese documents.

                      I suggest you use manual translation, do not use machine translation.

                      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 →
                      • Typo on Azure Basic web application training page

                        https://docs.microsoft.com/en-us/azure/architecture/reference-architectures/managed-web-app/basic-web-app#deploy-the-solution

                        Typo under the diagram in the Architecture "Note" section:
                        "This architecture doe not focus on application development"
                        change from "doe" to "does"

                        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 →
                        • Endpoint Protection Exclusions setting

                          i has installed the Endpoint Protection.when i use the Exclusions to exclude some file i don't want to scan. it does work when i take this setting.But the next time i found that the setting was disappear. the situation comes often. it would nice if u can tell me why it cause;
                          thanks

                          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 →
                          • Make MS Dev Centre documentation pages viewable in Edge Reading View

                            A good way to promote Edge is to make sure it can at least be using on MS dev centre doc pages. It's frustrating that MS own content is not viewable in it's optimum form e.g. like https://docs.microsoft.com/en-us/windows/uwp/data-binding/data-binding-in-depth cannot be switched to reading view!

                            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 →
                            • "Quick Reference (C++/CX) looks bad to the point is not useful"

                              This is the link:

                              https://docs.microsoft.com/en-us/cpp/cppcx/quick-reference-c-cx

                              This an image:

                              http://imgur.com/a/Z7Qoz

                              As you can see the "Remarks" column can't be seen. I'm looking at it right now using a "DELL Latitude e7470" ultrabook so it is a 14.0 inches screen with 1920 x 1080 resolution.

                              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 →
                              • Receive notification when someone replies to a comment

                                Hello,

                                When leaving a comment in any of the articles in docs.microsoft.com, is there a way to receive a notification if someone replies to my comment?

                                Thanks,
                                Tony

                                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 →
                                • UWP API document os so lag

                                  The new UWP API document page is so lag. When a page is loaded, it's hard to scroll up/down no matter using Edge or IE or any other browser (no one care the animation of the scrolling, they just want to see the content as soon as possible).
                                  Developer who use UWP API document is to look for certain keyword or information, the new API document design is not as clear as before.

                                  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 →
                                  • Add APIversion dropdown for the ARM templates

                                    The new ARM documentation is great. Should be nice to add the different api versions per schema (likewhise a dropdown)

                                    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  ·  Suggestion  ·  Flag idea as inappropriate…  ·  Admin →
                                    • Almost unusable!

                                      This site has become almost unusable - because all drop down box functionality disappears!

                                      When the page loads I can see the drop down box character '>' appearing on items in the navigation pane but very soon they all disappear, this happens with Edge, internet Explorer and Chrome.

                                      The MSDN documentation site still works - this may have started after installing the anniversary edition of Windows 10 Pro (15063.138).

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

                                          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

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

                                          Feedback and Knowledge Base