Add info about race condition to scaladoc.