improving getAll documentation