diff --git a/README.md b/README.md
index fbbba92..8b4f061 100644
--- a/README.md
+++ b/README.md
@@ -4,16 +4,135 @@ Perceptual Color Space and Language based on the CAM16 Uniform Color Space
## Defining and Manipulating Colors
color-cam16 is a TypeScript library for defining and manipulating colors. Generate color sequences. Define color relationships. Determine color differences. Find analogous and complimentary colors. Ensure color contrast. Match real world colors.
-The library uses a uniform color space based on human perception and human semantics. You can define a set of colors by their relationships in plain text. Define colors as warmer, cooler, lighter, darker, stronger, weaker, analogous, triadic, or complimentary. Declare how many steps between colors to form color sequences. The library will parse the color description and generate a set of colors for a color theme.
+The library uses a uniform color space based on human perception and human semantics. You can define a set of colors by their relationships in plain text. Define colors as warmer, cooler, lighter, darker, stronger, weaker, analogous, triadic, or complimentary. Declare how many steps between colors to form color sequences. The library will parse the color description and generate a set of colors.
-## Color Space Transforms
-- JuMuHu_to_color
-- label_to_color
+## Color Language
+### `parse_colors(text: string): CAM16u[]`
+
+```
+require { parse_colors } import 'color-cam16'
+
+color_gradient = parse_colors('1A5 to 9Z5 in 5 steps')
+warm_colors = parse_colors('1A5 to 9Z5 in 15 steps')
+cool_colors = parse_colors('9a5 to 1z5 in 15 steps')
+rainbow = parse_colors('rainbow in 26 steps')
+
+```
+Color gradient
+
+
+
+
+
+
+
+Warm colors
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Cool Colors
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
+Rainbow Colors
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Hue A
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+- rainbow_colors
+- adjust_color
+
+## Color Space Transforms
+- JuMuHu_to_color
+- label_to_color
## Color Space Analysis
- delta_e
- find_closest_color
@@ -26,7 +145,3 @@ The library uses a uniform color space based on human perception and human seman
- name_to_color
- find_closet_names
-## Color Language
-- parse_colors
-- rainbow_colors
-- adjust_color