Annotate all internal functions with '@internal'

Even though some functions are expored from src/**/*.js files they are private. The only function exported by src/index.js and src/*/index.js are considered to be part of the public API. Please see: https://github.com/graphql/graphql-js/blob/master/src/README.md

It would be great to have all private API marked as such, e.g.: https://github.com/graphql/graphql-js/blob/6f341a3ae0d6b3cc4d9136a58fd9272c615c2dba/tstypes/validation/validate.d.ts#L32-L33

Also, it would be great to find all public APIs without JS doc comments.

[IvanGoncharov]

@craicoverflow Thanks a lot for #2205 I merged it in but I will keep this issue open to tracking the development of ESLint rule. Another great subtask would be to check that all public functions have doc comments.

[nveenjain]

I created a babel-plugin for the same since we are using only ExportNamedDeclarations, this plugin only extracts the list of exported variables with ExportNamedDeclarations… This means that code like

 export let name1, name2=5, nameN;

is not supported, and name1, name2, nameN will not be output of the plugin… However this can be modified if required… You can check the plugin live at:- https://astexplorer.net/#/gist/01dc219b927b6a72efc1ca00a92fa0be/35b47cf3831059793f993bbd3a4d71b140759972

You can check the console to get the array of exported names/functions…