docs: improve docs/examples

Author: skovy

README.md

@@ -5,7 +5,6 @@ css-codemod is a toolkit for running codemods over many CSS files to transform c
 - Any [PostCSS syntax parser and stringifier](https://github.com/postcss/postcss/blob/main/docs/syntax.md) can be added. This extends support for additional syntaxes like SASS and LESS.
 - Any [PostCSS plugin](https://github.com/postcss/postcss/blob/main/docs/plugins.md) can be added. This allows running any plugin as a one-off transform. This can be useful if you want to run a plugin once and remove it from a build tool or convert between syntaxes.
 - Any [PostCSS helpers](https://postcss.org/api/) for working with nodes and the abstract syntax tree can be used to transform CSS arbitrarily to fit your needs.
-- Custom helpers provided by css-codemod to streamline some types of transforms.
 
 ## Install
 
@@ -177,6 +176,8 @@ export const parser = parse;
 export const plugins = [calc({})];
 ```
 
+For more examples, see the [codemod recipes](https://github.com/skovy/css-codemod/tree/main/recipes).
+
 ### PostCSS
 
 [PostCSS](https://postcss.org) is the core tool used for performing code transformations. As a result, much of it's API is re-surfaced in this toolkit and will link to it's documentation.

recipes/color-props-to-red/transform.ts

@@ -9,5 +9,11 @@ export const transform: Transform = (fileInfo, api) => {
     }
   });
 
+  // Or, using more specific PostCSS helpers.
+  //   Docs: https://postcss.org/api/#root-walkdecls
+  root.walkDecls('color', decl => {
+    decl.value = 'red';
+  });
+
   return root.toString();
 };

recipes/uppercase-selectors/transform.ts

@@ -9,5 +9,11 @@ export const transform: Transform = (fileInfo, api) => {
     }
   });
 
+  // Or, using more specific PostCSS helpers.
+  //   Docs: https://postcss.org/api/#rule-walkrules
+  root.walkRules(rule => {
+    rule.selector = rule.selector.toUpperCase();
+  });
+
   return root.toString();
 };