documented needed children methods