[doc] Updating documentation to reflect recent changes

This documents the minor API change introduced in version 3.0.0