Document "short" and "long" cache services

Created by: MegaphoneJon

See https://github.com/civicrm/civicrm-core/pull/12873.