aboutsummaryrefslogtreecommitdiffstats
path: root/packages/monorepo-scripts/src
diff options
context:
space:
mode:
authorFabio Berger <me@fabioberger.com>2018-08-23 06:25:06 +0800
committerFabio Berger <me@fabioberger.com>2018-08-23 06:25:06 +0800
commita6cdc38d532b897442bac74bc3fd1735c85317ba (patch)
tree52d586abb4878cb618d1c7429ec437421729284e /packages/monorepo-scripts/src
parent167c4f851945e86eb08502b3f85fcb8befb2508e (diff)
downloaddexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.tar
dexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.tar.gz
dexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.tar.bz2
dexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.tar.lz
dexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.tar.xz
dexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.tar.zst
dexon-sol-tools-a6cdc38d532b897442bac74bc3fd1735c85317ba.zip
Add/improve comments
Diffstat (limited to 'packages/monorepo-scripts/src')
-rw-r--r--packages/monorepo-scripts/src/doc_gen_configs.ts6
1 files changed, 6 insertions, 0 deletions
diff --git a/packages/monorepo-scripts/src/doc_gen_configs.ts b/packages/monorepo-scripts/src/doc_gen_configs.ts
index fb6cc0886..6d7560943 100644
--- a/packages/monorepo-scripts/src/doc_gen_configs.ts
+++ b/packages/monorepo-scripts/src/doc_gen_configs.ts
@@ -1,7 +1,10 @@
import { DocGenConfigs } from './types';
export const docGenConfigs: DocGenConfigs = {
+ // Versions our doc JSON format so we can handle breaking changes intelligently
DOC_JSON_VERSION: '0.0.1',
+ // Some types that are exposed by our package's public interface are external types. As such, we won't
+ // be able to render their definitions. Instead we link to them using this lookup.
EXTERNAL_TYPE_TO_LINK: {
Array: 'https://developer.mozilla.org/pt-PT/docs/Web/JavaScript/Reference/Global_Objects/Array',
BigNumber: 'http://mikemcl.github.io/bignumber.js',
@@ -25,6 +28,9 @@ export const docGenConfigs: DocGenConfigs = {
Schema: 'https://github.com/tdegrunt/jsonschema/blob/v1.2.4/lib/index.d.ts#L49',
ValidatorResult: 'https://github.com/tdegrunt/jsonschema/blob/v1.2.4/lib/helpers.js#L31',
},
+ // Sometimes we want to hide a constructor from rendering in our docs. An example is when our library has a
+ // factory method which instantiates an instance of a class, but we don't want users instantiating it themselves
+ // and getting confused. Any class name in this list will not have it's constructor rendered in our docs.
CLASSES_WITH_HIDDEN_CONSTRUCTORS: [
'ERC20ProxyWrapper',
'ERC20TokenWrapper',