feedback icon indicating copy to clipboard operation
feedback copied to clipboard

Site is hard to use without the floating mini TOC on each page

Open lonix1 opened this issue 2 years ago • 6 comments

Describe the bug Documents used to show a mini floating TOC on the right hand side of each page. It's been replaced with an "Additional resources" section, which is useless and should be shown at the bottom.

Articles are much harder to grok without that mini TOC. I have to continually scroll up and down to determine where I am, or scroll to the top to look at the full TOC.

Useability of the docs site is much poorer because of this.

To Reproduce Visit any page.

Expected behavior Floating mini TOC on the right of every page.

Screenshots An example screenshot I found of the old layout:

Desktop (please complete the following information): all desktops

Smartphone (please complete the following information): n/a

Additional context

lonix1 avatar Sep 02 '23 01:09 lonix1

Thank you for opening an issue! One of our team members will get back to you with additional information.

If this is a product issue, please close this issue and contact the product's support instead. For a list of support websites, see Support for Microsoft products and apps.

welcome[bot] avatar Sep 02 '23 01:09 welcome[bot]

FYI @keziamicro

gewarren avatar Sep 08 '23 18:09 gewarren

Related to #3925.

gewarren avatar Sep 08 '23 18:09 gewarren

The other thing missing is the "Time to read article" (in minutes), which is a handy way to determine the complexity of an article. It was a tiny text at the top of each page.

lonix1 avatar Sep 08 '23 21:09 lonix1

@lonix1 Yes, the time to read was removed in April 2023. This was the explanation for that:

The feature works great for simple articles but is misleading when a customer is trying to work through more complex documentation. In our world, time to read is one thing but time to comprehend and DO is quite another. Because the “time to read” feature is hurting more than helping our users and since comprehension time is not a straightforward calculation, we’ve decided to retire it effective April 2023.

gewarren avatar Sep 08 '23 22:09 gewarren

I guess you can't satisfy everyone - I (and everyone in my office) found it very useful to size up an article before reading. If it said 60 minutes, I would prepare a 60 minute timeslot sometime during the day.

The algorithms that calculate those figures are old and established and quite accurate. So I guess those that complained are non-native English speakers, thus the higher time-to-comprehension. Hence I don't think it was a good decision to remove it for everyone.

Oh well, at least the docs are of a superb quality, so it's not all bad.

lonix1 avatar Sep 08 '23 22:09 lonix1