Updated docs for weights.

Author: James O'Cull

README.md

@@ -8,6 +8,7 @@ Currently available units:
 
 - Length
 - Temperature
+- Weight
 
 ### Example
 
@@ -25,6 +26,7 @@ extern crate measurements;
 
 use measurements::length::Length;
 use measurements::temperature::Temperature;
+use measurements::weight::Weight;
 
 let football_field = Length::from_yards(100.0);
 let meters = football_field.as_meters();
@@ -33,4 +35,9 @@ println!("There are {} meters in a football field.", meters);
 let boiling_water = Temperature::from_celsius(100.0);
 let fahrenheit = boiling_water.as_fahrenheit();
 println!("Boiling water measures at {} degrees fahrenheit.", fahrenheit);
+
+let metric_ton = Weight::from_metric_tons(1.0);
+let united_states_tons = metric_ton.as_short_tons();
+let united_states_pounds = metric_ton.as_pounds();
+println!("One metric ton is {} U.S. tons - that's {} pounds!", united_states_tons, united_states_pounds);
 ```

src/lib.rs

@@ -62,8 +62,18 @@ pub mod length;
 #[allow(dead_code)]
 pub mod temperature;
 
-/// TODO: Provide docs and examples for this.
+/// The `Weight` struct can be used to deal with weights in a common way.
 /// 
+/// #Example
+/// 
+/// ```
+/// use measurements::weight::Weight;
+/// 
+/// let metric_ton = Weight::from_metric_tons(1.0);
+/// let united_states_tons = metric_ton.as_short_tons();
+/// let united_states_pounds = metric_ton.as_pounds();
+/// println!("One metric ton is {} U.S. tons - that's {} pounds!", united_states_tons, united_states_pounds);
+/// ```
 #[allow(dead_code)]
 pub mod weight;