more javadocs for optional header keys