4 ms·
Introducing .NET Core Docs
- jc4p 10y agoI know it _just_ launched but oh my god how do you launch such a slow site. I'm trying to load the "System.Drawing" API docs and Chrome inspector just shows a GET pending alongside a _lot_ of analytics and marketing calls being made. I waited to see how long it'd take, 30s to load the page: http://i.imgur.com/Z6y1ulSr.png http://i.imgur.com/Z6y1ulSr.png Anyway, ignoring the launch issues: My #1 annoyance with MSFT documentation is sub-classes being on a different page. If you want to call a DirectX method which takes 4 inputs, you need to open up a new tab for each of those inputs to see the possible values / etc. I hate it, very very much. I hope their new documentation doesn't have this issue, I'll check back again in a few weeks to see if I can actually load pages on this site.
- dend 10y agoThanks for the feedback! I am a PM on the docs team and will direct your feedback right now to the engineering team to look into the perf issue.
- BillinghamJ 10y agoIf you disable javascript, the site works and loads in ~50ms. You should consider deleting all/most of the JS :)
- dend 10y agoI am forwarding all this feedback to engineering, we're on it :) Thanks for diagnosing potential causes!
- 616c 10y agoIt is nice to see MS people out and approachable. Generally speaking, as I posted in another child comment in the same thread, this is the biggest let down of MS redesign of the last year and led to a huge backlash in a HN article that escapes me. If your JS hangs my browser for static content, I avoid your page and recommend others do too. I doubt I am the only one!
- 616c 10y agoAs someone who works in IT and generally does not like opening pages with JS full on (yes, I am one of those NoScript uBlock elitists), it is insulting that almost no KB article or other main page will load without throwing an enable JS blanket. It has been discussed here before. As an IT professional, the only system that upsets me more than Microsoft on this point is Symantec. I expect clean minimalist doc pages from system dev and anti-virus companies. I do not need fancy MVVM pages and tracking JS to know what you fixed in your latest bug release, thank you!
- dsp1234 10y agoother main page will load without throwing an enable JS blanket I expect clean minimalist doc pages from system dev You're in luck. The documents that are being discussed work without javascript enabled. https://docs.microsoft.com/en-us/dotnet/core/api/index https://docs.microsoft.com/en-us/dotnet/core/api/index Click on "System" https://docs.microsoft.com/en-us/dotnet/core/api/System https://docs.microsoft.com/en-us/dotnet/core/api/System Scroll down and click on "Array" https://docs.microsoft.com/en-us/dotnet/core/api/system.array#System_Array https://docs.microsoft.com/en-us/dotnet/core/api/system.arra... Scroll down and click on "OverflowException" https://docs.microsoft.com/en-us/dotnet/core/api/system.overflowexception#System_OverflowException https://docs.microsoft.com/en-us/dotnet/core/api/system.over... etc... all without javascript.
- Someone 10y agoYou also want to work on your SEO. Because I couldn't find a search box that searched all documentation on my iPad, I googled toarray site:docs.microsoft.com That produces 3 hits, all on JavaScript source maps, for example https://docs.microsoft.com/en-us/microsoft-identity-manager/deploy-use/_themes/javascript/c5f4dbe04936a4cc7258.reference.js.map https://docs.microsoft.com/en-us/microsoft-identity-manager/...
- dend 10y agoNoted, we'll work on fixing that. Thanks for the flag!
- jklinger410 10y agoEver since the launch of 10 Microsoft's methodology seems to be all about analytics.
- jsingleton 10y agoLooks nice. Much more useful than the original release with only the Enterprise Mobility docs.
- dend 10y agoThank you for the feedback! We will gradually migrate more documentation to our new docs portal.
- deleted 10y ago[deleted]
- haft 10y agoThis is so much better than the old Technet approach. I especially appreciate the UX that went into creating the site - https://docs.microsoft.com/teamblog/introducing-docs-microsoft-com/ https://docs.microsoft.com/teamblog/introducing-docs-microso... Is there any change this will be available as an option for local documentation from VS? Sandcastle is a little dated.
- dend 10y agoWe don't have any announcement for this yet, but stay tuned on our blog and Twitter (@docsmsft). Feel free to also submit this piece of feedback here: https://msdocs.uservoice.com https://msdocs.uservoice.com
- jbtule 10y agoIsn't this it? https://dotnet.github.io/docfx/ https://dotnet.github.io/docfx/
- quaffapint 10y agoIt could be because it's just a work in progress, but I'm not seeing code examples like there were in the current version of the docs site.
- dend 10y agoIt's work in progress - we will add them soon!
- tracker1 10y agoA couple suggestions here... embed them in the docs on the site, I can't access gist, for example at work, so often have to reread, or use my phone to see them when referenced in blog posts, for example. The second suggestion, would be to show (maybe under a tab/collapse) what imports one needs... I specifically remember learning C# when it first came out between books and using the cli compiler without benefit of VS, and had a beast of a time figuring out that an example with StringBuilder required System.Text, or some such be imported into my class file. It's something that always bugs me when I see snippets without a reference to the namespaces that are needed.
- dend 10y agoNoted. We are working on the code snippet experience as we speak.