giza: docs improvements