Справку и пояснения(ну и, к слову, комментарии) надо писать хотя бы для того, чтобы потом самой можно было вспомнить, как оно тут работает-то.