docs: add docs for the new api.

Remove one of *also*/*same*::