add readme and validate identifiers