The required documentation changes were described in
SERVER-32051. The docs changes should take effect as of 3.6.0, even though this ticket will not be backported until 3.6.1.
The second attempt after
SERVER-32051 was reverted, because it didn't work if the replica set was started using a config file with the 'replSetName' option.