update public docs