Typescript specific docs about types HOT 3 OPEN

I'm thinking we can add comments between any imports and the exports of the type files. eg

import { Ord } from './util/tools';

/*
 * Comments go here
 */
export function max<T extends Ord>(a: T, b: T): T;
export function max<T extends Ord>(a: T): (b: T) => T;

We can then grab them in the build script and include them in the packaged index.d.ts. At some point we can get them into the ramda website as well.

Does anyone have any thoughts on more general ramda related typescript docs/thoughts/guidelines? Should we add a TYPESCRIPT.md?

from types.

Also as an idea, maybe we can use tests for it somehow? In tests(in DefinitelyTyped) there are examples how to use it with typescript with comments.

from types.

transferred from the main repo, feel free to close if we want to track this another way

from types.