added doc, now nicer behavior for orientation computation