start adding docstrings

docs/source/conf.py

@@ -32,7 +32,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx.ext.autodoc", "sphinx_rtd_theme"]
+extensions = ["sphinx.ext.autodoc", "sphinx_rtd_theme", "sphinx.ext.intersphinx", "sphinx.ext.napoleon"]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -62,3 +62,7 @@
 html_static_path = ["_static"]
 
 html_show_sphinx = False
+
+# -- Intersphinx ---------------------
+
+intersphinx_mapping = {'graphql': ('https://graphql-core-3.readthedocs.io/en/stable', None)}

docs/source/index.rst

@@ -24,3 +24,4 @@ GraphQL + SQLAlchemy <3
    :caption: Reference
 
    reference/query
+   reference/api

docs/source/reference/api.rst

@@ -0,0 +1,7 @@
+API Reference
+=============
+
+.. automodule:: graphql_sqlalchemy
+   :members:
+
+.. autofunction:: graphql_sqlalchemy.build_schema

src/graphql_sqlalchemy/schema.py

@@ -87,6 +87,15 @@ def build_mutations(model: DeclarativeMeta, objects: Objects, mutations: GraphQL
 
 
 def build_schema(base: DeclarativeMeta, enable_subscription: bool = False) -> GraphQLSchema:
+    """
+
+    Args:
+        base:
+        enable_subscription:
+
+    Returns: :class:`graphql:graphql.type.GraphQLSchema`
+
+    """
     queries: GraphQLFieldMap = {}
     mutations: GraphQLFieldMap = {}