Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Include a fixed box index for every documentation page, displaying the content of the article #3928

Open
carloswm85 opened this issue Jun 17, 2023 · 4 comments
Labels
enhancement Make the docs.microsoft.com experience better Pri3

Comments

@carloswm85
Copy link

Is your feature request related to a problem? Please describe.

I've been using https://learn.microsoft.com/ for a while. And in pages like this one https://learn.microsoft.com/... there is a section at the top of the page with the content of the article which is ok, but it is pretty unhandy for navigating the content when I'm in the middle of the page, at the button or anywhere else.

And this is a repetitive problem throught most of the documentation.

Describe the solution you'd like

Add the same index as a floating HTML element, to the right hand side of the viewport (which for the most part in unproductice and unused white space).

Here's an example from the Bootstrap site: https://getbootstrap.com/docs/5.3/getting-started/introduction/#quick-start But as you can see, it is not a perfect use case. It should not behave like that when reaching the bottom of the page. See the screen recording.

Describe alternatives you've considered

This is the most I can think of.

Additional context

What we have:

chrome_PjE2Kdfham

What we could improve:

chrome_B6wzpRkQk4

@carloswm85 carloswm85 added the enhancement Make the docs.microsoft.com experience better label Jun 17, 2023
@welcome
Copy link

welcome bot commented Jun 17, 2023

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.

@gewarren
Copy link
Member

@carloswm85 Thanks for the feedback. We've heard this a lot and hope to prioritize a fix for it.

@carloswm85
Copy link
Author

Hello, @gewarren

I've seen that the team has implemented this suggestion. But I have to say that it was not what I was expecting.

chrome_dBzTAjKJ6U

What I was expecting is to see the actual content of the article ("In this article" section) on the side bar, and not the "Additional resources" section. That way, the readers can move quickly through the different and main sections of their reading.

Something like "Additional resources" should be secondary to this, and be displayed at the bottom of the page (in a section footer) or in a toggleable setiong in that same side bar.

Let me know if you need additional comments from me, please.

Toggleable example from Notion app:

chrome_acMOravxb5

@Flachdachs
Copy link

It seems nothing has changed since I opened my ticket #3925. "Additional resources" were already placed in the right column at this time. But not every page has this section. I gave up the hope that this annoying change will be reverted soon and wrote for myself a user script that moves the "In this Article" section back to its usual place. I'll publish it in my ticket.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Make the docs.microsoft.com experience better Pri3
Projects
None yet
Development

No branches or pull requests

3 participants