I’m fiddling with so much Hugo-related, so I try to stay away from the docs site … But I tried your PR a while ago, and while it may solve a lot of issues, it also looks different typographically (to little in the padding / margin department maybe).
I tried your PR a while back and felt the same as the others have said.
I’d prefer to see https://github.com/spf13/hugo/issues/1725 finished and merged. There’s a lot of discussion in that PR that have little to do with the design that we could do later (reorganize content, search, etc).
Sure, as long as the priority is to make the site prettier and remove some of the spaghetti front-end code from making the site less navigable, particularly on mobile. I’m deferring to @sjardim on this one since he is the one that reworked the docs to use the CodyHouse theme. As far as reorganizing content, search, etc later, I think that would likely necessitate a redesign, if for no other reason than things like titling and terms need to be changed in multiple areas to keep the site intuitive. Content before form.
@digitalcraftsman handles most of the docs PR vetting and merging, so he’s the acting “docs maintainer” in my mind. But contributions matter more than titles. If you have the time and talent to take over maintaining a portion of the project or leading a big redesign, I, for one, would be happy to have you come alongside us.
I think everyone was on-board with your reorg ideas. We just need to make it happen.
@MarkDBlackwell Did you rework any of the content, btw, or is this strictly a visual redesigning of the site? If nothing else, this seems to make the menu usable on mobile, which is an upgrade unto itself.
Thank you @MarkDBlackwell for investing the time to push this ideas forward The changes look great and I would like to see this theme going live.
Here are a few more points that could be discussed:
the menu sub-times could have a greater line-height (i.e. more vertical space to it’s neighbours)
the parent container of the bottom panel (with the text “Last revision: XXX XX, 2017”) add a margin on the left and right. Hence the bottom panel can’t fill the whole parent container
are previous/next page buttons actually required? I rarely use them and prefer to use the menu on the left because I can see sections are about. In conclusion this would make them obsolete. But my UX could differ from others.
the accordion menu on the left highlights the current menu entry (whose submenu is expanded) as well as the previously clicked menu entry. I’m using Chrome 56 on Linux.
I’m not a fan of this new theme. It feels very cramped, like @digitalcraftsman already allured to with mentioning the line-height of the menu items.
The hamburger in the top is also crammed along the logo, and the Github buttons are also so close together that they seem one icon. Perhaps some of these icons can be left out, placed in the footer, or moved as the last menu entry?
What seems odd to me is that at other points, a lot (and I mean a lot) of screen space is used. For instance, the icons for next and previous, which are huge relative to the size of the menu.
But what I dislike most is how much space the TOC takes at the expense of the main content:
I think the TOC is much better handled on the current documentation site (by making it hover more). To me, giving a separate column to the TOC seems an excessive waste of space to me. Perhaps this can be made collapsible? With the current appearance I’d personally rather not have a TOC.
(Sorry for the pessimistic response of me. Besides the cramming and screen space issues I very much like this approach to Hugo docs.)
To be a bit more constructive, I personally would drop the left and right navigation buttons because (a) they take up a lot of space and (b) are redundant since the menu already offers this feature.
With those buttons removed, there’s also more room for padding of the article. That’s preferable to buttons I think, since a bit more padding makes the reading experience more pleasant and makes it feel less crammed. (Again, just speaking from my personal opinion here.)
And when the TOC cannot hover or collapse, I wouldn’t show it.
Personally, I find this a much cleaner reading experience (compared to the previous screenshot I posted):
Perhaps the title in the header can also be removed, since it seems redundant to have two titles. Perhaps the search, given its feature of performing a global search, is better placed in the header than in an individual article.
Alternatively, we could show the toc at the very top beneath the search field like here. This way it’s aligned with the text from top to bottom without taking to much space on the right, especially on smaller screens.
The only reason http://hugodocs.netlify.com/ have not replaced the current site is because only Steve have technical access to do that kind of upgrade.
And that is a limitation for any such effort. So until that is fixed …
http://hugodocs.netlify.com/ looks smashing and works fine on my dekstop browser. I can understand the need for mobile, but not mobile first … People do Hugo development on their desktops.
And, while I appreciate the efforts of thread starter, this theme does not pass the “desktop test”, so to speak. Even after several people have made the same remarks, it still has the same issues (sub par typography).
http://hugodocs.netlify.com/ on the other hand, looks smashing. If it has some problems with contrast or mobile: Fix that and stop starting to invent a new wheel every time you get a flat tire!