Update README.md

Author: prozz

README.md

@@ -6,11 +6,14 @@
 Go implementation of AWS CloudWatch [Embedded Metric Format](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)
 
 It's aim is to simplify reporting metrics to CloudWatch:
-- using EMF avoids additional HTTP calls as it just logs JSON to stdout
-- built in support for Lambda functions default dimensions and properties (happy to accept PR for EC2 support)
-- no need for defining additional dependencies (or mocks in tests) to report metrics from inside your code
+- using EMF avoids additional HTTP API calls to CloudWatch as metrics are logged in JSON format to stdout
+- no need for additional dependencies in your services (or mocks in tests) to report metrics from inside your code
+- built in support for default dimensions and properties for Lambda functions
+- TODO support for default dimensions and properties for EC2 (please send pull requests)
 
-Examples:
+Supports namespaces, setting dimensions and properties as well as different contexts (at least partially).
+
+Usage:
 ```
 emf.New().Namespace("mtg").Metric("totalWins", 1500).Log()
 
@@ -21,3 +24,29 @@ emf.New().DimensionSet(emf.NewDimension("format", "edh"), emf.NewDimension("comm
     MetricAs("wins", 1499, emf.Count).Log()
 ```
 
+You may also use the lib together with `defer`.
+```
+m := emf.New() // or some more complicated init setting up whatever you fancy
+defer m.Log()
+
+// any reporting metrics calls here
+```
+
+Functions for reporting metrics:
+```
+func Metric(name string, value int)
+func Metrics(m map[string]int)
+func MetricAs(name string, value int, unit MetricUnit)
+func MetricsAs(m map[string]int, unit MetricUnit)
+
+func MetricFloat(name string, value float64)
+func MetricsFloat(m map[string]float64)
+func MetricFloatAs(name string, value float64, unit MetricUnit)
+func MetricsFloatAs(m map[string]float64, unit MetricUnit)
+```
+
+Functions for setting up dimensions:
+```
+func Dimension(key, value string)
+func DimensionSet(dimensions ...Dimension) // use `func NewDimension` for creating one
+```