documents issue#28

Going to be a frequent issue - can we get this out-front and documented asap?