small documentation and metadata improvement