document generators and internal methods available for override