generated public docs