Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Introducing docs.microsoft.com

docs.microsoft.com

Post reply on HN
Print view View original

71–80 of 195 posts

Re: Introducing docs.microsoft.com

#71

Post by tallanvor »

Jedd wrote: post #20

At $DAY_JOB we have various document (or rather, knowledge) repositories -- a mostly-abandoned-but-still-useful-often-enough-to-not-ignore wiki, the obligatory but overwhelming salesforce, personal (silo) collections of email lists/archives, a semi-public knowledge base, a half-hearted attempt at moving internal mail lists into yammer, various product guides (PDF's), a public-access user forum, an LMS, and probably a…

A lot of companies do use SharePoint that way (including Microsoft), they just heavily modify the look, and in some cases (Microsoft kb articles, as an example) have publishing flows to export static pages to be cached by CDNs.

Re: Introducing docs.microsoft.com

#72

Post by txdv »

sz4kerto wrote: 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.

What monitor do you have?

Re: Introducing docs.microsoft.com

#73

Post by nailer »

pjmlp wrote: post #64
Iv wrote: post #37

I am glad to see they acknowledge MSDN is bad. I fear they will make it worse but well, we'll see. Microsoft has been surprising these times.

Just try to get Google or Apple OSes documentation. MSDN is the best documentation I ever seen from OS vendors. Not to mention the mainframe, commercial UNIX and embedded real time OSes, even worse than those mentioned above.

redhat.com/docs and (back when Sun was a thing) docs.sun.com were great.

Re: Introducing docs.microsoft.com

#74

Post by acqq »

userbinator wrote: post #47
zx2c4 wrote: 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…

can be overwhelming because of its length This makes no sense at all, even if you think people's attention spans have shortened. You see the same amount of content at once regardless of whether it's been paged, unless your browser window is ridiculously large or the content has been literally split into paragraph-per-page levels of fragmentation. You'll eventually get to see all the same content, but you have to spen…

> Maybe it's the result of some stupid "engagement" metric that awards clicking around?

It seems it's exactly this (I see I'm linking to your another post, but it really deserves to be prominent):

https://news.ycombinator.com/item?id=11627448

fyre.co Livefyre "The Leading Content Marketing and Engagement Platform" (a site slogan by that company)

Re: Introducing docs.microsoft.com

#75

Post by mediumdeviation »

WillKirkby wrote: post #65

Some CSS tweaks that make it slightly more bearable (at least on my 1920px wide display) /* disable social sharing buttons */ .lf-selection-popover,.lf-thread-btn{display:none;} aside#social{display:none;} /* make sidebar thinner and content wider */ @media only screen and (min-width: 1024px){#sidebar{max-width:20%;}} @media only screen and (min-width: 1024px){div#main{max-width:80%;width:auto;margin:0;}} body>div.co…

Are you sure making things wider actually makes it easier to read? Very long lines have make it hard for your eyes to track the start of the next line when you've reached the end of one. This is backed up by solid research, and is the main reason why books, magazines and a lot of websites have the width that they do.

Re: Introducing docs.microsoft.com

#76

Post by yread »

drglitch wrote: post #66
drglitch wrote: post #63

Livefyre sidenote feature breaks selection and copy/paste on iPhone - aside from being completely useless in first place. Sending snippets of docs via email and other means is key - and is so much easier than signing into a third party service, using some lame social share feature, and then trying to find your contact there instead. Aside from that, new layout looks nice!

Replying to self: tables are completely broken on mobile too - eg https://docs.microsoft.com/en-us/multi-factor-authentication... and scroll to 'options' - it's about 5 CHARACTERS wide on iPhone 6 :)

Well it looks quite horrible on desktop as well

Re: Introducing docs.microsoft.com

#77

Post by Sarang235 »

glaberficken wrote: post #67
pandler wrote: post #8

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

I also have the same ehabit. I a glad I am not the only one.

Re: Introducing docs.microsoft.com

#78

Post by seanmcdirmid »

cmrx64 wrote: post #25
foota wrote: post #19

Maybe 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

It looks like they are using segoe UI Light with a bad contrast (background too white, text too dark). Their visual design needs work.

Re: Introducing docs.microsoft.com

#79

Post by [deleted] »

jug wrote: post #41
foota wrote: post #19

Maybe I'm just losing my eyesight, but does anyone else find that font impossible to read?

Ironically I think these kind of thin font faces render worse on Windows than on both OS X (Quartz) and Linux (FreeType). An odd choice given their rendering engine's limitations, but hey, maybe they are just expecting people to move on to HiDPI displays where I think rendering engine deficiences are often taken care of by raw resolution.

[deleted]

Re: Introducing docs.microsoft.com

#80

Post by glaberficken »

Sarang235 wrote: post #77
glaberficken wrote: post #67

Earlier quoted context omitted.

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.

I also have the same ehabit. I a glad I am not the only one.

Interesting little curiosity about how triple-click implementation varies in some popular software =)

https://en.wikipedia.org/wiki/Triple-click

Post reply on HN