guide.macports.org can trigger migraines

[MarjaE2]

Guide.macports.org currently loads with:

• The guide itself on the right center of the window.

When users try to scroll, it adds:

• The navigation options on the left center of the window.

The guide scrolls, the navigation options do not, the sheer between these can trigger migraines.

Add-ons such as AlwaysKillStickies can remove the navigation section, but since the guide doesn't load before users scroll, we may not see the problem until we scroll. Also, removing the navigation section can make it harder to navigate.

Some options which would help:

• Loading the navigation section at the same time as the rest of the page.

• Loading the navigation section at the extreme left or right edge of the browser window instead of next to the guide itself.

Loading in Firefox 77.0.1. Add-ons such as

[ryandesign (Ryan Carsten Schmidt)]

Replying to MarjaE2:

The guide scrolls, the navigation options do not, the sheer between these can trigger migraines.

I wasn't aware of that. We could certainly make adjustments to the css if that would help.

• Loading the navigation section at the same time as the rest of the page.

I have never seen it not do that. I'm not able to reproduce this problem in Safari or Firefox or Chrome. The navigation does load with the rest of the page.

[MarjaE2]

If I load, for example, this link:

​https://guide.macports.org/#project.tickets

The navigation menue doesn't load until I start scrolling. Using FF 77.0.1. on MacOS 10.14.6. Using several accessibility fixes, but it's hard to list them all and I doubt they affect this.

[ryandesign (Ryan Carsten Schmidt)]

Thank you, I see what you're talking about now. If I load the guide with that #project.tickets anchor in the URL then yes I see that the navigation is not present at load (or is present but immediately disappears) and appears (or reappears) when scrolling. I don't know why it would be doing that but I haven't looked at the code. For me I see this happen all the time in Firefox but only intermittently in Chrome and Safari.

[JDLH (Jim DeLaHunt)]

I do not see this on my system. That is, I do not see the navigation not present at load, but appearing when I scroll. This is as of May 2021, using 88.0.1 on macOS 10.13.6. When I load ​https://guide.macports.org/#project.tickets , I see the content of the Guide appear in the main column of the page, and space reserved in the left column for the grey table of contents with links to various sections. I assume that this grey table of contents rectangle is what is meant by "navigation". It stays aligned with the Guide's "1. Introduction" heading in the main column, no matter how I scroll.