some hierarchy problems solved in documentation