DOC : added missing doc changes from #2844

@Tillsten This look good?