add alternative git revision endpoint option, spec, and documentation