more updates to comm spec doc
fixed formatting on basic flow