Revert "Revert "Add explanations to existing functions""

This reverts commit 7bd619fc5c222fd98b14ea613097827f66d08503.