📝 Prefer interfaces and functions for exported entities

[dubzzz]

In the context of the documentation extracted by api-extractor, it is better to have:

interface MyType {
  /** What does my attribute */
  attribute: any;
}

Over:

type MyType = {
  /** What does my attribute */
  attribute: any;
};

As the documentation related to the attribute will be ignored.

Same for functions versus variables.

Declaring a function as follow:

function abc() {}

Will produce a better extracted api than this one:

const abc = () => {}

In a nutshell

❌ New feature
❌ Fix an issue
✔️ Documentation improvement
❌ Other: please explain

(✔️: yes, ❌: no)

Potential impacts

None

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit eacf448:

Sandbox	Source
Vanilla	Configuration
dubzzz/fast-check: example	Configuration

[coveralls]

Coverage decreased (-0.03%) to 96.101% when pulling eacf448 on better-docs-last into 0c3080b on master.