documentation updated, header validation improved, unit tests updated