Hi, I just looked at the technical documentation page (on a laptop), so all my comments are about that.
First of all, the layout is clear and functional. Every button that I press does exactly what I’d expect it to do. So the fundamentals are solid. Well done!
That said, there are a number of things that could improve the UX slightly:
When I hover over any item in the sidebar, the layout of the whole menu jumps slightly. And then it does the same when my pointer leaves the highlighted item. This is super annoying. See if you can fix that.
The sidebar navigation menu is only useful when a user is at the top of the page. Did you consider making it sticky so that it’s still available to click on when a user is reading lower sections?
The buttons to return to the top of the page are a bit small and it took me a moment to find them. You might consider enlarging them, changing their color, or moving them to the left so that they’re more readily apparent.
When I click on any item in the sidebar, the page jumps to the appropriate section. This is fine, but a smoother scroll might be better. This might take some time to implement, however. You’re controlling navigation with
That would give you a smooth scroll instead of a jump. (I’m not 100% sure that it would look better, though. Since the page is fairly long, a smooth scroll all the way to the final section might be annoying. You could test it out.)
- When the page jumps to a section, the section heading is stuck right at the top of the viewport. It might be good to add a bit more margin or padding to give it a little space to breathe.
Again, these are all just tweaks that might improve the solid work you’ve already done. Good job!