documentation and improved usage of configuration deserialization