document ZSH workaround

[fdavis]

until #865 and #869 are merged in we should document this workaround to get ZSH autocomplete working:

#323 (comment)

[davidism]

Looks like some docs were merged, then #865 was merged, so this is done. #869 is an ZSH enhancement but not required.