doc: add documentation regarding our api tooling
Introduces a proper imperative description of how the current API documentation build system works.
Refs: https://github.com/nodejs/next-10/issues/169
cc @mhdawson @nodejs/next-10 @benhalverson @nodejs/tooling