add external data sources so people can generate their own metrics
syntax and doc fixes