fix documentation of aleatory variables