Improve config and context reference pages (#598)

Author: droserasprout

docs/book.css

@@ -47,3 +47,8 @@ img.logo {
     height: 1em;
     opacity: 50%;
 }
+
+/* less ugly autodoc references */
+dd .field-odd {
+    margin: 0;
+}

docs/conf.py

@@ -53,3 +53,7 @@
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
+
+# NOTE: Nice dataclasses
+autodoc_typehints = 'description'
+autodoc_typehints_format = 'short'

docs/config-reference.rst

@@ -1,2 +1,47 @@
-.. automodule:: dipdup.config
-   :members:
+.. autoclass:: dipdup.config.DipDupConfig
+.. autoclass:: dipdup.config.AdvancedConfig
+.. autoclass:: dipdup.config.BigMapHandlerConfig
+.. autoclass:: dipdup.config.BigMapIndexConfig
+.. autoclass:: dipdup.config.CoinbaseDatasourceConfig
+.. autoclass:: dipdup.config.ContractConfig
+.. autoclass:: dipdup.config.EventHandlerConfig
+.. autoclass:: dipdup.config.EventIndexConfig
+.. autoclass:: dipdup.config.HasuraConfig
+.. autoclass:: dipdup.config.HeadHandlerConfig
+.. autoclass:: dipdup.config.HeadIndexConfig
+.. autoclass:: dipdup.config.HookConfig
+.. autoclass:: dipdup.config.HTTPConfig
+.. autoclass:: dipdup.config.HttpDatasourceConfig
+.. autoclass:: dipdup.config.IndexTemplateConfig
+.. autoclass:: dipdup.config.IpfsDatasourceConfig
+.. autoclass:: dipdup.config.JobConfig
+.. autoclass:: dipdup.enums.LoggingValues
+   :members:
+   :undoc-members:
+.. autoclass:: dipdup.config.MetadataDatasourceConfig
+.. autoclass:: dipdup.config.OperationHandlerConfig
+.. autoclass:: dipdup.config.OperationHandlerOriginationPatternConfig
+.. autoclass:: dipdup.config.OperationHandlerTransactionPatternConfig
+.. autoclass:: dipdup.config.OperationIndexConfig
+.. autoclass:: dipdup.enums.OperationType
+   :members:
+   :undoc-members:
+.. autoclass:: dipdup.config.OperationUnfilteredHandlerConfig
+.. autoclass:: dipdup.config.OperationUnfilteredIndexConfig
+.. autoclass:: dipdup.config.PostgresDatabaseConfig
+.. autoclass:: dipdup.config.PrometheusConfig
+.. autoclass:: dipdup.enums.ReindexingAction
+   :members:
+   :undoc-members:
+.. autoclass:: dipdup.enums.ReindexingReason
+   :members:
+   :undoc-members:
+.. autoclass:: dipdup.config.SentryConfig
+.. autoclass:: dipdup.enums.SkipHistory
+   :members:
+   :undoc-members:
+.. autoclass:: dipdup.config.SqliteDatabaseConfig
+.. autoclass:: dipdup.config.TokenTransferHandlerConfig
+.. autoclass:: dipdup.config.TokenTransferIndexConfig
+.. autoclass:: dipdup.config.TzktDatasourceConfig
+.. autoclass:: dipdup.config.UnknownEventHandlerConfig