Update documentation on theory behind linear metrics