adds documentation on exactly what this solves