-
Notifications
You must be signed in to change notification settings - Fork 12
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
Hide github icon unless on developer page #41
Conversation
I vote to remove the GitHub logo from the theme altogether. On IRC, there have been concerns about us removing the GitHub logo, but this change is mostly to avoid users coming to GitHub, thinking it's a forum. We'll still prominently feature our open-source background; probably even bigger than the current logo. I believe we should prominently display it on the "Welcome Developers" page (GitHub logo, repo link and CI status). Also see #43 . |
I agree with removing entirely, as it reduces complexity of the implementation somewhat. As for implementation direction:
1 is cleaner from the user perspective, as we don't ship them un-used HTML, but less clean from a developer position as we need to override the theme partials and it's not immediately clear why from just looking at the code. 2 is much cleaner from a code perspective, as it's a single line change, and obvious what it is doing. But we are shipping HTML to the user that they will never see so it feels kinda klunky. There is also a third option, looking at the existing partials, it seems to suggest that simply removing the Maybe it's worth trying to upstream a PR to fix this bug in the theme so we can keep our own codebase clean? |
Yes. Removing |
I don't think this is a good idea. I often find myself quickly viewing a projects website for the sole purpose of looking for their Github. |
Fair comment. I think a counter to your point is this doesn't remove the github link entirely. The developer section has a link to the github repo prominently on the page, it also details important context for any potential contributor (XboxDev group ect.) I think this page is more valuable than the github repo by itself, so this change will help reduce non-developer users from hitting the github repo (poor experience, multiple screen pages to readme, readme not the most descriptive/useful for user). I also think this will improve the experience for potential contributors interested in the project as they are provided context before being routed to the repo which is pretty barren in this regard. |
What shall we do with this? |
I'll close this now. It's currently not going anywhere. Closed. |
Closes #39
Option 1 (this pr)
Overrides to the existing partials so that the github icon is not shown on any pages other than the developer pages.
I like that this implementation keeps the conditional display of the github icon in the templates, statically rendering to html.
I don't like how much code needs to be repeated:
Option 2
I also have an alternative implementation done with JS + CSS: https://github.com/DiscoStarslayer/xqemu.com/pull/1/files
I feel the intent of the code is clearer on the JS implementation, but I am not a big fan of the fact that it has to run in the browser instead of just being a statically rendered element.
Option 3
Just remove this icon all-together to avoid the added complexity. One line of CSS + a config change to
mkdocs.yml
will do this pretty cleanly.