I removed this because I found it not specific enough to be helpful. Maybe we should re-add it and be more specific? Or add Scaladoc to the methods instead?