fix children method, update jsdocs