Starting to use typedoc

[bryevdv]

I played around with typedoc for generating docs for rapids-js modules. Initial attempts were fairly unsatisfactory, but I stumbled across the new beta, which adds a "library mode" that is more suitable for projects like ours.

Some steps:

install typedoc beta (0.20)

npm install typedoc@beta

install babel template manually

Maybe a quirk on my system, I had to install this by hand

npm install @types/babel__template

run typedoc on a single module

npx typedoc --out testdocs modules/cudf/src/index.ts --excludePrivate --tsconfig modules/cudf/tsconfig.json

note that in previous versions --excludePrivate seemed to prevent attributes like _data from showing up, but they are still showing up for me when the beta is used.

[bryevdv]

Also to note: AFAIK we will need to invoke typedoc separately for each module to get good results, but I be missing some configuration option

[trxcllnt]

We have typedoc set up in Arrow and IxJS, and should be able to follow those examples. We can add an npm "doc" script to build the docs for each module, plus a typedoc.js config file to customize things.

[trxcllnt]

Done in:

1. Add typedoc configs and related scripts #61
2. Add script to compile typedocs into one top-level docs folder #70