Minor layout tweaks in documentation

libraries/Color.elm

@@ -1,4 +1,3 @@
-
 module Color where
 
 {-| Library for working with colors. Includes
@@ -13,12 +12,27 @@ built-in names.
 @docs complementary
 
 # Gradients
-@docs linear radial
+@docs linear, radial
 
 # Built-in Colors
-These come from the [Tango
-palette](http://tango.freedesktop.org/Tango_Icon_Theme_Guidelines).
-@docs red, orange, yellow, green, blue, purple, brown, black, white, grey, gray, charcoal, lightRed, lightOrange, lightYellow, lightGreen, lightBlue, lightPurple, lightBrown, lightGrey, lightGray, lightCharcoal, darkRed, darkOrange, darkYellow, darkGreen, darkBlue, darkPurple, darkBrown, darkGrey, darkGray, darkCharcoal
+These colors come from the [Tango
+palette](http://tango.freedesktop.org/Tango_Icon_Theme_Guidelines)
+which provides reasonable defaults for colors.
+Each color comes with a light and dark version.
+The six colors ranging from `lightGrey` to `darkCharcoal` are
+a compatible series of shades of grey.
+
+### Standard
+@docs red, orange, yellow, green, blue, purple, brown,
+      grey, gray, charcoal, black, white
+
+### Light
+@docs lightRed, lightOrange, lightYellow, lightGreen, lightBlue,
+      lightPurple, lightBrown, lightGrey, lightGray, lightCharcoal
+
+### Dark
+@docs darkRed, darkOrange, darkYellow, darkGreen, darkBlue,
+      darkPurple, darkBrown, darkGrey, darkGray, darkCharcoal
 
 -}
 

libraries/Dict.elm

@@ -8,7 +8,7 @@ module Dict (empty,singleton,insert
             ,toList,fromList
             ) where
 
-{-|A dictionary mapping unique keys to values. The keys can be any comparable
+{-| A dictionary mapping unique keys to values. The keys can be any comparable
 type. This includes `Int`, `Float`, `Time`, `Char`, `String`, and tuples or
 lists of comparable types.
 

libraries/Http.elm

@@ -1,12 +1,15 @@
-{-| A library for asynchronous HTTP requests (AJAX). See the
+{-| A library for asynchronous HTTP requests. See the
 [WebSocket](http://elm-lang.org/docs/WebSocket.elm) library if
 you have very strict latency requirements.
 
-# Types
-@docs Request, Response
+# Sending Requests
+@docs send, sendGet
 
-# Making requests
-@docs request, get, post, send, sendGet
+# Creating Requests
+@docs get, post, request
+
+# Responses
+@docs Response
 
 -}
 

libraries/Set.elm

@@ -6,9 +6,9 @@ module Set (empty,singleton,insert,remove
            ,toList,fromList
            ) where
 
-{-|A set of unique values. The values can be any comparable type. This includes
-`Int`, `Float`, `Time`, `Char`, `String`, and tuples or lists of comparable
-types.
+{-| A set of unique values. The values can be any comparable type. This
+includes `Int`, `Float`, `Time`, `Char`, `String`, and tuples or lists
+of comparable types.
 
 Insert, remove, and query operations all take *O(log n)* time.
 

libraries/Text.elm

@@ -3,14 +3,17 @@ module Text where
 
 {-| Functions for displaying text
 
-# Constructors
+# Creating Text
 @docs toText
 
-# Stylizing and displaying Text
-@docs typeface, monospace, header, link, height, color, bold, italic, overline, underline, strikethrough, justified, centered, righted, text, plaintext
+# Creating Elements
+@docs plainText, asText, text, centered, justified, righted
 
-# Converting other elements to Text
-@docs asText
+# Formatting
+@docs color, typeface, height, link
+
+# Simple Formatting
+@docs monospace, header, bold, italic, underline, overline, strikethrough
 
 -}
 

libraries/Time.elm

@@ -1,10 +1,16 @@
 module Time where
 
-{-| Library for working with time. Type `Time` represents some number of
-milliseconds.
+{-| Library for working with time.
 
-# Type and Constructors
-@docs Time, millisecond, fps, fpsWhen, every, since, timestamp, delay
+# Units
+@docs Time, millisecond, second, minute, hour,
+      inMilliseconds, inSeconds, inMinutes, inHours
+
+# Tickers
+@docs fps, fpsWhen, every
+
+# Timing
+@docs timestamp, delay, since
 
 -}