[Documentation] Why Roux?

[rubyFeedback]

I just found this project from reddit (that is, someone mentioned it on reddit aka "next generation CSS" or something like that).

Right now ... even after reading the README, I don't understand the use case.

The documentation has this content right now in regards to "Why Roux":

"Why Roux?

This project is meant as a guide to build up your own CSS architecture. This isn't a UI library, style guide, or a framework like Tailwind. This is to help you (as a designer, developer, anyone) feel empowered to set up your very own styles successfully."

So, I know what HTML, CSS etc... is, but I do not understand the word "CSS architecture". It may be obvious to you
folks, but I have no idea what is meant with this.

Then the next sentence says what Roux is not, aka "this isn't a UI library" which ... does not really help me understand
what it IS about.

The third sentence tells me it will help me (as designer, developer etc...) "feel empowered". Well, I already feel epic
all the time, but ... I have no idea what "empowered" means. Naturally if we use some code in a project, we may be
able to do something useful with it. Thus "empowered". But ... this doesn't tell me anything right now really.

Then it says "to set up your very own styles" - here I also don't have the slightest idea what is meant with a
"style". Is this a CSS template?

Anyway. My intention is not to cherry-pick on this really. People are free to describe their projects in any way they
see fit, of course. My problem here is that after reading this paragraph a few times, I still have no idea what this
project is about. I had a look at the codepen, it shows HTML, CSS and JavaScript but ... I am none the wiser.

Could you perhaps reconsider describing what Roux is, to a semi-newbie? I don't mean a clueless person, but
someone who does understand some of the tech jargon, but still doesn't completely understand the use case
of Roux, e. g. what we can do with it specifically, why it is necessary and so forth. If it is about extending CSS,
perhaps this could be made more clear; or in any way the description could be more accurate. Right now I only
know that Roux has something to do with CSS, but I have no idea what. (Mentioning Tailwind may help folks
who know Tailwind; I don't though and probably other visitors may not know the use case of Tailwind either).

At any rate thank you for reading this. Feel free to close this issue at any moment in time.

[enatario]

Hi @rubyFeedback thanks so much for taking the time to write this — this is really helpful feedback. Also I converted your issue to a discussion for now!

You’re right that the README jumps straight into “CSS architecture” without explaining what that means or when someone would actually use Roux.

In short: Roux is meant to help people set up and organize their CSS from scratch — it’s not a UI kit, but a structured starting point (folders, variables, base styles) to keep styles consistent and scalable.

That said, I’d love to better understand what was unclear so I can improve the docs.

I'd love to follow up your questions with questions of my own so I can better clarify:

• When you first looked at the repo, what did you expect Roux to do? (e.g. generate CSS, style components, compile something, etc.)
• Were you hoping to see more examples of what kind of project Roux is useful for?
• Would it help if the README showed a “before and after” example — e.g. starting with an empty project vs. one initialized with Roux?
• Is there a particular part of the README (like the “Why Roux” section) that felt confusing or too abstract?

[enatario]

PR here for clarification