documenting remaining functions