Skip to content

Intro to poetic css - #1060

Open
mirisuzanne wants to merge 5 commits into
mainfrom
poetic-css-intro
Open

Intro to poetic css#1060
mirisuzanne wants to merge 5 commits into
mainfrom
poetic-css-intro

Conversation

@mirisuzanne

@mirisuzanne mirisuzanne commented Feb 12, 2026

Copy link
Copy Markdown
Member

Related Issue

https://github.com/oddbird/oddFlock/issues/278

Description

@SondraE this is my draft of an article introducing poetic CSS, and giving a progress update. I know it will probably go out on the newsletter first, but figured this would be a good place to write/review it, since it will probably land on oddsite eventually?

@github-actions

Copy link
Copy Markdown

View diff of compiled files (may take a few minutes): https://github.com/oddbird/oddleventy-built/compare/main..poetic-css-intro

@SondraE SondraE left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You probably don't need a title and subtitle for the wait list email because that should be more informal in tone, but for the website, I'm wondering about a subtitle that states the benefit of the course. Something like:

  • Learn to write CSS more quickly and efficiently
  • A course to understand CSS's internal system logic
  • A course to completely change how you think about CSS
  • Stop fighting the language at every step

I hear over and over that CSS feels like a series of workarounds, rather than a unified system. And sometimes that’s because there are essential features missing from the language, but often it’s a problem with the way CSS is taught.

This initial paragraph feels like it could use an "and therefore I made a course" phrase of some sort. Something like, "I (Miriam) want to change that." or "Thus, the Poetic CSS course was born."

For the website: Should have a CTA to the course page after this initial paragraph and at the end of the article.

For the waitlist email: I think it would be good to invite the waitlist folks to interact with you if they want. Would you like to hear their opinion about what should be in the course? Or what modules to make first? Or their top 2 questions about CSS? Or what sort of payment model they like the best for video courses?

Include in the Making progress section that we are aiming to launch spring 2026 with pre-sales starting sometime before that.
For the Making progress section I wonder whether you could get a still image from the setup montage to break up the text.

You are planning to include the intro video with the demo, right? I think that could be included in both the website article and waitlist email. In the article text, it would probably be good to mention the video and that you've included a demo which is a sneak peek of what people can expect from the course. (That video should go on the course landing page too.)

@dvdherron dvdherron left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Like Sondra suggested, I'm mainly wondering if there's a way to briefly introduce the course earlier in the text. I think as of right now "Poetic CSS" only appears in the subtitle.

Comment thread content/blog/2026/poetic-css-intro.md Outdated
Comment thread content/blog/2026/poetic-css-intro.md Outdated
the first set of lessons.

But there's a lot more to do
Turning a series of videos into a _course_

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there punctuation missing before "Turning"?

Comment thread content/blog/2026/poetic-css-intro.md Outdated
to _express our intent_
without being overly restrictive.

There are many excellent CSS courses in the world,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if there's a way to move parts of this section to the very top? Some type of brief introduction to the course before you go into your background in teaching/education?

mirisuzanne and others added 2 commits February 13, 2026 10:02
Co-authored-by: david herron <41588129+dvdherron@users.noreply.github.com>
@mirisuzanne

Copy link
Copy Markdown
Member Author

@SondraE @dvdherron I moved some things around and tried to address your review. @SondraE we can come back to this and finish up the website details, but I want to prioritize what you need for an email.

Is it too long?

@dvdherron dvdherron left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Your changes makes this a better introduction to the idea behind the course. I don't think this is too long. If others think it's too long, maybe this could be split into separate posts/e-mails?

  • The vision of the course + the "making progress" section.
  • And the side quest section stands alone?

Comment thread content/blog/2026/poetic-css-intro.md Outdated
to style the web _without_ inheritance?
Let's try it!

… video here? …

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That makes sense to me.

Co-authored-by: david herron <41588129+dvdherron@users.noreply.github.com>

@jgerigmeyer jgerigmeyer left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! It's a lot of text, but hopefully we can break that up with some images/diagrams/videos before publishing.

@@ -0,0 +1,223 @@
---
title: CSS is one big progressive enhancement

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: CSS is one big progressive enhancement
title: CSS Is One Big Progressive Enhancement

title: CSS is one big progressive enhancement
sub: Learn the internal logic of CSS in my new course
author: miriam
date: 2026-02-12

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update this before publishing

sub: Learn the internal logic of CSS in my new course
author: miriam
date: 2026-02-12
action:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to use the Poetic CSS image here?

Suggested change
action:
image:
src: pages/poetic-css.jpg
alt: ''
position: center
action:


{%- import 'utility.macros.njk' as utility -%}

There are many excellent CSS courses in the world,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
There are many excellent CSS courses in the world,
There are many excellent CSS courses out there,

and I recommend learning from more than one source.
Many of them are by top-notch designers,
if that's an angle that interests you.
But this course is all about systems:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
But this course is all about systems:
But this course is all about _systems_:


We'll cover individual features
like flexbox, grid, and container queries,
but we'll also re-visit

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
but we'll also re-visit
but we'll also revisit

Comment on lines +48 to +49
helping you write better CSS,
without the struggle and confusion.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
helping you write better CSS,
without the struggle and confusion.
**helping you write better CSS,
without the struggle and confusion.**

Comment on lines +124 to +125
you're probably right!
Universal design certainly makes things complicated!

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
you're probably right!
Universal design certainly makes things complicated!
you're probably right --
universal design certainly makes things complicated!

Comment on lines +152 to +163
Sometimes when I'm working on a lesson,
I end up down a rabbit hole
that feels interesting but tangential
to the main thread.
The other day,
I filmed one of these 'side quests'
to include as extra material --
and to get a feel for my setup.
Let me know if you find this sort of tangent
interesting!
Maybe you'll catch my 'todo' slide
that makes a brief appearance! :)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Sometimes when I'm working on a lesson,
I end up down a rabbit hole
that feels interesting but tangential
to the main thread.
The other day,
I filmed one of these 'side quests'
to include as extra material --
and to get a feel for my setup.
Let me know if you find this sort of tangent
interesting!
Maybe you'll catch my 'todo' slide
that makes a brief appearance! :)
{% callout 'note', false %}
Sometimes when I'm working on a lesson,
I end up down a rabbit hole
that feels interesting but tangential
to the main thread.
The other day,
I filmed one of these 'side quests'
to include as extra material --
and to get a feel for my setup.
Let me know if you find this sort of tangent
interesting!
Maybe you'll catch my 'todo' slide
that makes a brief appearance! :)
{% endcallout %}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants