Update discussion documentation

@chrisndodge pls review