[doc] fixes and cleanups for custom api usage chapter.