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

    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

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

      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

        2 comments  ·  Flag idea as inappropriate…  ·  Admin →
      • Docs page layout should allow to collapse side columns

        Currently side columns on docs pages have fixed width and on iPad they are too wide. They force the middle context column to be too narrow, do not use full real estate, and, in particular for code examples, I have to scroll it right and left all the time to read the text.

        It will be better to allow user to collapse left and right columns and expand them only when needed

        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  ·  Flag idea as inappropriate…  ·  Admin →
        • Make docs.microsoft.com a Office365 application

          For internal company documentation.

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

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

              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 →
              • Add cmd.exe / batch file docs

                Please add all the old docs for cmd.exe / batch file commands from:
                https://technet.microsoft.com/en-us/library/bb490890.aspx
                It's only a few pages of very "old & boring" things, but very important and helpful since it's so arcane.

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

                  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 →
                  • EntityFramework Docs on Landing Page

                    When I enter the landing page https://docs.microsoft.com/ the EntityFramework docs should be there as a category (probably next to the ASP.NET docs link).

                    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 →
                    • tell me how can I close F12 Developer Tools permanently? Now it starts when I am in netbank transfering money and that is very annoying.

                      tell me how can I close F12 Developer Tools permanently? Now it starts when I am in netbank transferring money and that is very annoying.

                      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 →
                      • 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 →
                        • Make it possible to Share with linkedin

                          Linkedin sharing. You own linkedin for God sake.

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

                            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 →
                            • Cognitive Services add documentation for the APIs please.

                              sad state of cognitive services documentation. there are (as of this post) 2 how-tos for over a dozen services. that makes only 1/6th with some semblance of documentation. how can we preview or use the service if we don't have direction on its use?

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

                                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 →
                                • 在页面上有个错误

                                  https://docs.microsoft.com/zh-cn/dotnet/
                                  这个页面上面 'c入门#' 应该是'C#入门'

                                  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 →
                                  • Navigation pane gets too short when scrolled down

                                    When you scroll to the bottom of https://docs.microsoft.com/en-us/windows/uwp/input-and-devices/speech-recognition the left navigation pane is resized to about half of the available height.

                                    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 →
                                    • Use Visual Studio colors for code

                                      In code snippets, the methods are colored as classes but shouldn't be, parameter types or types in general are not colored at all. Would be nice if the coloring was consistent with Visual Studio; Roslyn might help with that.

                                      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 →
                                      • Add a sign-in button to the landing page on developer.microsoft.com

                                        developer.microsoft.com is easy to remember and I often use this to get to my Dashboard. Can we add a sign-in or dashboard link direct from the home 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  ·  Flag idea as inappropriate…  ·  Admin →
                                        • Suggestion for Azure Documentations :: You should provide questionnaires on every document to ensure the person has read it correctly

                                          Suggestion for Azure Documentations :: You should provide questionnaires on every document to ensure the person has read it 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

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

                                          General Site Feedback

                                          Feedback and Knowledge Base

                                          automatically in just a few seconds. -->