-
Notifications
You must be signed in to change notification settings - Fork 309
About the guide's usability. #463
Comments
Should we move this to hexo-theme-meteor? |
I think the first point is actually a bug, looking at it now. |
Active highlighting is dup of meteor/meteor-theme-hexo#10 Unless it's hard for you/dom to track, I'd prefer just pointing in the readme to hexo-theme, but not going through the hassle of moving the issues that get submitted here/docs anyway. But if you'd like, I can start doing that. |
Sorry guys, didn't know about the hexo-theme-meteor repo. |
@7immy - why would you? :) |
Good point :) |
Thanks @7immy for the suggestions :) Here are my thoughts on two of them: Page ToC
On mobile, since the menu is hidden, I would like to see the page's ToC duplicated at the top of the page. You think it's important on desktop as well? I can see the ToC fine in the menu: Scrolling down pagesI identify with the difficulty in scrolling down a page scanning headers. Especially looking for an API function. If I start at the top of http://docs.meteor.com/api/collections.html and start scrolling down looking for insert, it doesn't pop out at me: Partially because it's in the middle of
At one point all the header anchor icons were red, and I didn't like it on pages like this with a few headers in view at once: I think a darker gray or red just on the h2s would help me have a sense of structure level. |
Cheers @7immy for the collated feedback it really does help us move quickly on improvements. Thank you! These are done:
This one is a bit more complex:
I'm wary that such a change pushes the content too far down the page. It's great for the shape of laravel content, however when presented with many headings and subheadings e.g., package.js it gets out of hand. If this is a pressing issue, I'd suggest creating a ticket in the Meteor hexo theme repo to discuss it further. |
Closing to keep things tidy. Please open new issues for further improvements! |
I'm really excited about the guide :) It seems to be getting lots of updates and now has some really great tips and examples in there! Thank you sooo much guys! :)
That said it is starting to get quite hard to read the pages and effectively navigate the sidebar as more and more topics and sub topics are added and each page is getting longer and longer.
I had a few UX/UI and style ideas that may help below:
Sidebar
Pages
Just some thoughts,
Thanks for reading :)
The text was updated successfully, but these errors were encountered: