Fix metadata key characters

Added explicit error message in the case where you attempt to add metadata with a '.' in the key name.  Added a test and some docs as well.