#178 done reorganise notification functions
#178 edit variable docs