Port !13169 "update consensus doc" to alpha doc

The following discussion from !13169 (merged) should be addressed:

• @julien.t started a discussion:

  These changes need to be ported to Alpha.