From 89a21e7d6a0c6a7d98b7fa3a7b5814c11e124ca7 Mon Sep 17 00:00:00 2001 From: nelsonic Date: Mon, 16 Dec 2019 11:17:34 +0000 Subject: [PATCH] update intro copy in "Why?" section of elm-ui #145 --- tutorials/elm-ui/README.md | 32 +++++++++++++++++++++++--------- 1 file changed, 23 insertions(+), 9 deletions(-) diff --git a/tutorials/elm-ui/README.md b/tutorials/elm-ui/README.md index f14cb49..8ef96ef 100644 --- a/tutorials/elm-ui/README.md +++ b/tutorials/elm-ui/README.md @@ -1,18 +1,35 @@ # `elm-ui` a Language for _Reliable_ Layout and Interface +_This_ tutorial aims to take a complete beginner - +who has never seen any `elm-ui` - +to a basic understanding in 10 minutes. + ## _Why?_ 🤷 ... 😢 🌧 `|>` 😍🌈 -@dwyl we _love_ the idea of having semantic and functional UIs -with no side-effects. Functional CSS allows anyone +Few people _love_ writing CSS. +Most people just want to build their App's layout +_without_ the headache of knowing how to position things. +`elm-ui` lets you build beautiful, fast and responsive UIs in `elm`, +without writing _any_ CSS. +But `elm-ui` goes _way_ beyond offering a design system, +because it's built using pure `elm` functions, +it gives you compile-time guarantees that your layout/styles +are valid. So not only is it easier/faster to build the UI, +it makes extending and _maintaining_ your App _effortless_! + +> @dwyl we _love_ the idea of having semantic, functional and responsive UIs +with no side-effects.
+**Functional CSS** libraries allow anyone on a team to change _one_ style on a single element -without affecting any others. +without affecting any others.
For the past few years we have been using the Tachyons library -see: https://github.com/dwyl/learn-tachyons +see: +[github.com/dwyl/**learn-tachyons**](https://github.com/dwyl/learn-tachyons) and it's been a breath of fresh air. Using Tachyons in dozens of projects -has been _good_ in small teams (_max 8 people_) -and we have had far fewer UI bugs than before adopting Tachyons. +has been _good_ in small teams (_0-12 people_) +and we have had _far_ fewer UI bugs than before adopting Tachyons. _However_ we have found that even with a functional CSS library (_that greatly reduces the possibility of cascading side effects_), we still see redundant and unnecessary styles @@ -28,9 +45,6 @@ That's where `elm-ui` comes in and changes the game! for building semantic UI with compile-time guarantees. -_This_ tutorial aims to take a complete beginner -who has never seen any `elm-ui` to a basic understanding. - Matthew Griffith described it eloquently in his Elm Conf talk "Building a Toolkit for Design":