new logic: doc helper