giza: comments and docs strings