Live data from Hacker News

Introducing docs.microsoft.com

docs.microsoft.com

101–110 of 195 posts

Re: Introducing docs.microsoft.com

#101
post #3

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

Ha! So a lot of us have that strange problem! :) And I hate it too when websites do funky pop-up stuff on text selection. But somehow, I don't see that problem on this website. Which browser are you using?

Re: Introducing docs.microsoft.com

#102

Nice to see MSDN move to more modern design. But I don't see any search capability? Shameless pug, We currently working on documentation hub for developers https://www.docsapp.io/

As someone searching for an enterprise grade replacement to our current system of using MS word -> pdf -> CD to publish and maintain 500+ user and install guides... -what flavor of Markdown do you support (captions/TOC/auto-number figures and tables) -can I paste images from the clipboard directly into the editor (like one can with github issues)? -what's the advantages over setting up my own git repo and using somet…

Here is link to demo published site https://demo.docsapp.io/

- We support Github Flavored Markdown

- We dont have paste image from clipboard, but we will add the feature idea to roadmap.

- We provide support for versioning, fulltext search, private internal documentation (soon)

Re: Introducing docs.microsoft.com

#103
post #3

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

Ha! So a lot of us have that strange problem! :) And I hate it too when websites do funky pop-up stuff on text selection. But somehow, I don't see that problem on this website. Which browser are you using?

I see this on Firefox on Win10. And you have to hit the back button twice to go back, which happens on a lot of Microsoft sites.

Edit: looks like it's being served from fyre.co, which might be blocked by adblockers?

Re: Introducing docs.microsoft.com

#104
post #70
post #3

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

> On my 32" 4K display, 70% of the screen is empty. Totally agreed on your other points (particularly about animations on selection) but as the article mentions, eye tracking repeatedly shows people have trouble reading very wide text. Also many people use large monitors to have multiple windows, rather than a single window maximised.

I stopped maximizing my browser window a long time ago, and I only have a 27" monitor. It's just not comfortable for me.

Re: Introducing docs.microsoft.com

#105
post #103

Earlier quoted context omitted.

Ha! So a lot of us have that strange problem! :) And I hate it too when websites do funky pop-up stuff on text selection. But somehow, I don't see that problem on this website. Which browser are you using?

I see this on Firefox on Win10. And you have to hit the back button twice to go back, which happens on a lot of Microsoft sites. Edit: looks like it's being served from fyre.co, which might be blocked by adblockers?

Strange. I'm using Firefox on Win7 here, but it shouldn't have been Windows difference. Will check when I go home where I have Win10.

Re: Introducing docs.microsoft.com

#106

Earlier quoted context omitted.

Use NoScript or equivalent to block scripts from the domain fyre.co. This prevents that annoying menu from popping up.

> Livefyre: The Leading Content Marketing and Engagement Platform Looks like something to block regardless of whether it creates annoying menus. Is anyone else a little surprised (and perhaps repulsed) by Microsoft putting semi-shady 3rd-party scripts like this on their site? This seems completely opposite of what the Microsoft I knew would do.

I've seen them used to power comments on some sites, which is why I left them enabled after I installed Ghostery. I might reconsider if I see them putting junk into other websites though.

Re: Introducing docs.microsoft.com

#107
post #14
post #2

From 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…

Their solution appears to be actually worse than the initial state, if they simply automatically split the long pages and add "prev - next" buttons. The proper solution for them is to look at Wikipedia as an example. Tables of contents in longer articles, manually introducing the new topics or reorganizing when it's reasonable. And it's not something that can be automated. Automatic splitting of long pages to shorter…

Not to mention, it makes it harder using Ctrl + F to find information.

Re: Introducing docs.microsoft.com

#108
post #100
post #99

Yikes. Seems that almost no one designing websites bothers to study the more important parts of typography. Recently, typography has been bastardized to mean "an expensive looking sans serif font." But there is really important knowledge out there regarding ease of reading, contrast, ideal formatting, etc. Cant believe that they choose a font weight that is so light. That alone makes this redesign way worse than the…

The blog portion uses a light font. The documentation part doesn't.

Well I jumped the gun then. I just assumed they would use the chance to show off their new format with a post about their new format. Guess not.

Looking at the actual documentation site, its not bad on first glance.

Re: Introducing docs.microsoft.com

#109
post #8
post #3

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

Hey, don't sell yourself short. It's akin to using your finger while reading a book. It helps you to keep your place and focus, which the highlighting in browsers works even better for. So I wouldn't necessarily call it a quirk that Microsoft doesn't have to account for. Webdevs should really stop overriding browser defaults in detriment to the user experience. (nothing is more evil than clipboard hijacking)

Re: Introducing docs.microsoft.com

#110
post #17

Are they going to fix the page load times? MSDN is terrible for click-wait-scroll usage, especially if you're trying to use the left navigation drilldown.

I wasn't sure if it was just an issue of my browser, plugins, or the site was just agonizingly slow. Apparently it was the latter.
Post reply on HN