Earlier quoted context omitted.
Me too, anyone know why this is a thing? Such a common twitch... does it help reading?
I do not have any data on it (1) but I think it's like moving a bookmark across the page as you are reading: it makes it easier to jump from the end of one line to the start of the next one. (1) not even on the claim that that bookmark has that effect.
Introducing docs.microsoft.com
161–170 of 195 posts
Re: Introducing docs.microsoft.com
#162Oh no. It pops up a quick menu when I select text, like Medium. The problem is that I'm constantly selecting the lines I'm reading. :( Edit: Also, it's extremely narrow. On my 32" 4K display, 70% of the screen is empty. And the font is too think. And stuff keeps moving/jumping when I'm moving the mouse cursor. I want 1998 back.
Welcome to the last few years. I thought, when i bought a 24 inch monitor, I'd be using all of it; instead I'm minimizing Firefox so that sites don't look silly. I guess when you're using technology as badly designed as that used to create/display websites anything harder than justifying text and images becomes a nightmare to develop and support.
Re: Introducing docs.microsoft.com
#163Earlier quoted context omitted.
> The problem is that I'm constantly selecting the lines I'm reading I'm glad to hear I'm not the only one! I compulsively select random blocks of text: select up, select down, repeat. I definitely get annoyed with the popup-menu-on-select feature of Medium, but I feel I can hardly blame Medium for my random, compulsive habit.
I share this "pain". I have the unshakable habit of triple-clicking a paragraph to highlight it to serve as a mark of where I was at when i need to interrupt reading.
No, clicking four times doesn't select the whole page.
Re: Introducing docs.microsoft.com
#164Oh no. It pops up a quick menu when I select text, like Medium. The problem is that I'm constantly selecting the lines I'm reading. :( Edit: Also, it's extremely narrow. On my 32" 4K display, 70% of the screen is empty. And the font is too think. And stuff keeps moving/jumping when I'm moving the mouse cursor. I want 1998 back.
> And stuff keeps moving/jumping when I'm moving the mouse cursor. Yes it's quite bad on that blog post, but if you check out an article [1] it doesn't suffer from that problem. Still has the selection-reader [2] problem, though. [1] https://docs.microsoft.com/en-us/remoteapp/remoteapp-whatis [2] https://blogs.msdn.microsoft.com/oldnewthing/20150528-00/?p=...
Yes, this is a bug and something we will fix, thanks for calling this out :)
Re: Introducing docs.microsoft.com
#165Oh no. It pops up a quick menu when I select text, like Medium. The problem is that I'm constantly selecting the lines I'm reading. :( Edit: Also, it's extremely narrow. On my 32" 4K display, 70% of the screen is empty. And the font is too think. And stuff keeps moving/jumping when I'm moving the mouse cursor. I want 1998 back.
> The problem is that I'm constantly selecting the lines I'm reading I'm glad to hear I'm not the only one! I compulsively select random blocks of text: select up, select down, repeat. I definitely get annoyed with the popup-menu-on-select feature of Medium, but I feel I can hardly blame Medium for my random, compulsive habit.
I suspect it's related to some patterns when reading books, like putting a bookmark below your current line and moving it down, or following your current position with your finger.
Re: Introducing docs.microsoft.com
#166From TFA: "Shortened Article Length Another common piece of feedback was that our content at times can be overwhelming because of its length and that long articles are more difficult to navigate and find what you’re looking for. To address this, we’ve broken down many longer articles into smaller logical steps and provided Previous and Next buttons at the bottom of articles to navigate between steps in a multi-part t…
Thanks for the feedback, and we went through a lot of customer feedback already on this. I'll try to be brief in a response
- A good example on why - For our documentation we clearly saw customers jumping around content trying to find the part of the article that helps them. Depending on the article (see point #2) very few people read from beginning to end. A good example here is that instead of having separate articles on how to setup iOS, Android and Windows phone devices with Intune, the previous articles had that as part of a much later article. If an admin who's company has standardized on Android, they want just the Android content, they don't want to have to sift through iOS/Windows troubleshooting to get to the Android setup content. For SEO, it's also much more likely that they'll find the solution by Googling (with or without Bing) to something like "Setup Intune Android" and go directly to the page that takes care of just that task. For developers, we face the same problem where some articles include multiple langauges and code samples are duplicated. Instead of doing that, we would break the article into pieces by language.
- Another key reason is not all content is built the same. We'd get feedback that many of our competitors have a much simpler "Getting Started" tutorial, while ours would be much longer and we'd get feedback that it seems more complex or overwhelming. When you are just starting off, "Hello World" is a lot better than War & Peace. It's about thinking about the right level of content for the task our customers are going through. In some cases, it's fine to have one long article.
- We will also provide the option for customers to have all content together versus having content broken into separate pieces and made available for offline. Customers want both.
- The reason we called this out is that the previous architecture doesn't not even have this as a capability.
I hope this helps give some context on the decision and thanks for the feedback.
Re: Introducing docs.microsoft.com
#167I think the main issue with documentation for Microsoft products/APIs is that the content is spread out on a large number of different Microsoft domains which makes it inherently difficult to find something. I have also often found (after using google to find the relevant article) that the content is either out of date or not relevant anymore. Adding yet another site to the list of sites which might or might not have…
Agree. Actually I'd already be happy if they stopped moving stuff around for no reason. I get "This object has moved" or worse "This object no longer exists" or just a redirect to some generic "Download Windows 10" page all the time on Microsoft documentation sites. :(
Thanks, this is great feedback and something we totally agree and want to fix. We recently created a redirection service, which historically did not exist on MSDN/TechNet so that when content moves, we can properly 301 redirect content to the correct place. This will help for net new content that moves, but as you correctly point out, we still have a lot of work to do for existing content.
Thanks again for the feedback!
Re: Introducing docs.microsoft.com
#168Maybe I'm just losing my eyesight, but does anyone else find that font impossible to read?
I also find it hard on my eyes. Looks like it's "Segoe UI" embedded via web fonts. If you compare their screenshot: https://docs.microsoft.com/teamblog/content/images/2016/05/D... To one of mine: https://imgur.com/rFwTqUW It's not even close. Edit: Seems the "blog" portion is very different than the actual docs: https://imgur.com/YKvFxCh
Thanks folks, we had Segoe UI Light on the blog and have switched it to use the same font as our docs!
Re: Introducing docs.microsoft.com
#169Oh no. It pops up a quick menu when I select text, like Medium. The problem is that I'm constantly selecting the lines I'm reading. :( Edit: Also, it's extremely narrow. On my 32" 4K display, 70% of the screen is empty. And the font is too think. And stuff keeps moving/jumping when I'm moving the mouse cursor. I want 1998 back.