aboutsummaryrefslogtreecommitdiff
path: root/build/improving-githubs-new-design/index.html
diff options
context:
space:
mode:
authorBradley Taunt <bt@btxx.org>2024-06-06 08:05:12 -0400
committerBradley Taunt <bt@btxx.org>2024-06-06 08:05:12 -0400
commit6b742c459266b18e2b375b35205ce8a6c02f0452 (patch)
treeb16fbb9a045e33dd6c97eb5ab72e6ff4d9237ea3 /build/improving-githubs-new-design/index.html
Initial commit
Diffstat (limited to 'build/improving-githubs-new-design/index.html')
-rw-r--r--build/improving-githubs-new-design/index.html98
1 files changed, 98 insertions, 0 deletions
diff --git a/build/improving-githubs-new-design/index.html b/build/improving-githubs-new-design/index.html
new file mode 100644
index 0000000..6f4aa02
--- /dev/null
+++ b/build/improving-githubs-new-design/index.html
@@ -0,0 +1,98 @@
+<!doctype html>
+<html lang="en" id="top">
+<head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <link rel="icon" href="data:,">
+ <title>Improving Github's New Design</title>
+ <link href="https://bt.ht/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" />
+ <style>*{box-sizing:border-box;}body{font-family:sans-serif;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{overflow:auto;}table{text-align:left;width:100%;}</style>
+</head>
+
+<nav>
+ <a href="#menu">Menu &darr;</a>
+</nav>
+
+<main>
+<h1>Improving Github's New Design</h1>
+<p>2020-07-07</p>
+<p>Like many other Github users, I am not a big fan of their recent repository page redesign. In my mind it seems like a change just for the sake of change - the original UI worked perfectly fine.</p>
+<p><em>Sigh.</em></p>
+<p>I was planning on recreating the original Github layout with custom CSS but decided against it. Tackling such a big change in design would cause headaches if Github ever changed even one simple class or id on a given element. My final conclusion was to just improve their new design with my own personal quality of life improvements.</p>
+<p>So, enough chit-chat. Let's get into it.</p>
+<h2>Current Design (2020)</h2>
+<p>The default view for a repo's homepage and ticket items are locked at a set <code>max-width</code>. This causes some visual strain in comparison to the full-width headers and navigations directly above. I use a decently sized montior when using your app Gitub - <strong>let me use all the space available to me</strong>!</p>
+<p><figure>
+<img src="/public/images/github-design-current.webp" alt="Current Github design">
+<figcaption>The current design of a repo's homepage. (<a href="/public/images/github-design-current.webp">direct link to image</a>)</figcaption>
+</figure></p>
+<p><figure>
+<img src="/public/images/github-ticket.webp" alt="Github ticket design">
+<figcaption>The current design of a ticket item (<a href="/public/images/github-ticket.webp">direct link to image</a>)</figcaption>
+</figure> </p>
+<h2>My Improvements</h2>
+<p>Your users shouldn't have to jump around the page looking for the important information they want to see. Resetting the basic repo information to the left side of the screen allows user to <em>instantly</em> read-up on the project details. (This design is catered towards left-to-right readers mind you).</p>
+<p>We now also utilize all the available screen space, dependent on the user's browser window size.</p>
+<p><figure>
+<img src="/public/images/github-design-current-redesign.webp" alt="Current Github redesign">
+<figcaption>The repo's homepage now uses all available space (<a href="/public/images/github-design-current-redesign.webp">direct link to image</a></figcaption>
+</figure></p>
+<p>We make similar updates to the ticket item view and also remove the out-of-place <code>margin-bottom</code> from the project link headers.</p>
+<p><figure>
+<img src="/public/images/github-ticket-redesign.webp" alt="Github ticket redesign">
+<figcaption>Github ticket items now align better with their header siblings (<a href="/public/images/github-ticket-redesign.webp">direct link to image</a>)</figcaption>
+</figure> </p>
+<h2>Try It Yourself!</h2>
+<p>You can very easily implement these custom CSS changes with an extension for the browser of your choice:</p>
+<p> <em>Firefox: <a href="https://addons.mozilla.org/en-US/firefox/addon/styl-us/">Stylus</a>
+ </em> Chrome: <a href="https://chrome.google.com/webstore/detail/stylebot/oiaejidbmkiecgbjeifoejpgmdaleoha">Stylebot</a></p>
+<p>Then create a new custom CSS file to target <code>github.com</code> with the following properties:</p>
+<pre><code>.container-xl {
+ max-width: 100%;
+}
+
+.repository-content .gutter-condensed.gutter-lg {
+ flex-direction: row-reverse !important;
+}
+
+.repository-content #discussion_bucket .gutter-condensed.gutter-lg {
+ flex-direction: row !important;
+}
+
+.repohead &gt; div.d-flex {
+ margin-bottom: 0 !important;
+}
+
+#show_issue {
+ display: flex;
+ flex-direction: row;
+ flex-wrap: wrap;
+}
+
+.repository-content #discussion_bucket,
+#partial-discussion-header {
+ width: 100%;
+}
+</code></pre>
+<p>That's it! Feel free to improve on this and further make it your own! I might create a new repo for this project if I end up adding even more improvements to the core CSS.</p>
+<footer role="contentinfo">
+ <h2>Menu Navigation</h2>
+ <ul id="menu">
+ <li><a href="/">Home</a></li>
+ <li><a href="/projects">Projects</a></li>
+ <li><a href="/uses">Uses</a></li>
+ <li><a href="/wiki">Wiki</a></li>
+ <li><a href="/resume">Resume</a></li>
+ <li><a href="/colophon">Colophon</a></li>
+ <li><a href="/now">Now</a></li>
+ <li><a href="/donate">Donate</a></li>
+ <li><a href="/atom.xml">RSS</a></li>
+ <li><a href="#top">&uarr; Top of the page</a></li>
+ </ul>
+ <small>
+ Built with <a href="https://git.sr.ht/~bt/barf">barf</a>. <br>
+ Maintained with ♥ for the web. <br>
+ Proud supporter of <a href="https://usefathom.com/ref/DKHJVX">Fathom</a> &amp; <a href="https://nextdns.io/?from=74d3p3h8">NextDNS</a>. <br>
+ The content for this site is <a href="https://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA</a>.<br> The <a href="https://git.sr.ht/~bt/bt.ht">code for this site</a> is <a href="https://git.sr.ht/~bt/bt.ht/tree/master/item/LICENSE">MIT</a>.
+ </small>
+</footer> \ No newline at end of file