noise and random inline documentation work

#252