Skip to content

Commit 2a52b58

Browse files
committed
Update About page, add Design page
1 parent 3326cb2 commit 2a52b58

File tree

3 files changed

+27
-1
lines changed

3 files changed

+27
-1
lines changed

app/content/layouts/article.html.erb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<%= render PageHeader.new(
55
title: current_page.data.title!,
66
description: current_page.data.description,
7-
published_on: current_page.data.published.to_date
7+
published_on: current_page.data.published&.to_date
88
) %>
99
<%- if current_page.data.toc -%>
1010
<aside>
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
title: Site Design
3+
layout: article
4+
---
5+
6+
I’d like to first acknowledge the layout and aesthetic of this site borrows heavily from [garrettdimon.com](https://garrettdimon.com)—I love the simplicity of Garrett‘s site along with his commitment to accessibility. He also has "meta" content to help educate readers; not only is there a meta section of the website, but the HTML source often includes explanatory comments addressed to folks like me peeking under the hood. This is very much in spirit with what I‘d like for Joy of Rails. Please check out [Garrett’s site](https://garrettdimon.com/) for great content related to software development and running a SaaS business, among other topics.
7+
8+
The design leans heavily into CSS grid. I’m a relatively new student of CSS grid so I’m sure the approach could be improved. I built a 12 column layout from using https://utopia.fyi to generate based grid, layout, and type settings as CSS variables.
9+
10+
Speaking of, the color theme of the site is also driven by CSS variables. Taking a cue from Tailwind’s default color palettes, I liked the idea of building the color theme off a monochromatic scale. This led me to [`chroma-js` ](https://www.npmjs.com/package/chroma-js) which can generate a scale given seed colors. Joy of Rails can now swap out its color theme given a recognized color name. It’s currently hard-coded but a future release will allow readers to swap out the color themselves.
11+
12+
The first iteration of this site’s design was built with Tailwind. With the new design taking shape, I’ve decided to remove Tailwind. I want to Joy of Rails to "own more" of its dependencies—part of why I implemented [Authentication from Scratch](https://github.com/joyofrails/joyofrails.com/pull/149). I love Tailwind, but in moving in this direction, it felt freeing to realize I [don’t need a CSS framework](https://www.smashingmagazine.com/2022/05/you-dont-need-ui-framework/). This does mean a more work is required in HTML and CSS to make styles and accessibility work better for readers.
13+
14+
Even though I’ve removed Tailwind as a dependency, I copied many of the Tailwind utility classes I was using directly into my application styles help with the transition. Over time, I may be able to pare down this set of classes, but I can see how many of them will continue to be useful in the future.
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: About Joy of Rails
3+
layout: article
4+
description: Joy of Rails is a Rails application dedicated to teaching and showing programmers how to use Ruby on Rails and highlighting news, notes, and contributions relevant to the broader Ruby on Rails community. It is open sourced on Github.
5+
updated: 2024-06-23
6+
---
7+
8+
Joy of Rails is a Rails application dedicated to teaching and showing programmers how to use Ruby on Rails and highlighting news, notes, and contributions relevant to the broader Ruby on Rails community. It is [open sourced on Github](https://github.com/joyofrails/joyofrails.com).
9+
10+
## Design
11+
12+
I’ve written more in-depth about the [design](/about/design) of this site.

0 commit comments

Comments
 (0)