docs: fix sphinx problems and add autodoc

Author: erikwrede

docs/api.rst

@@ -1,4 +1,18 @@
 API Reference
-====
+==============
 
-.. automodule::graphene_sqlalchemy
+SQLAlchemyObjectType
+--------------------
+.. autoclass:: graphene_sqlalchemy.SQLAlchemyObjectType
+
+SQLAlchemyInterface
+-------------------
+.. autoclass:: graphene_sqlalchemy.SQLAlchemyInterface
+
+ORMField
+--------------------
+.. autoclass:: graphene_sqlalchemy.fields.ORMField
+
+SQLAlchemyConnectionField
+-------------------------
+.. autoclass:: graphene_sqlalchemy.SQLAlchemyConnectionField

docs/conf.py

@@ -23,7 +23,10 @@
 # import os
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
+import os
+import sys
 
+sys.path.insert(0, os.path.abspath(".."))
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -80,7 +83,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:

docs/inheritance.rst

@@ -112,12 +112,13 @@ class to the Schema constructor via the `types=` argument:
 See also: `Graphene Interfaces <https://docs.graphene-python.org/en/latest/types/interfaces/>`_
 
 Eager Loading & Using with AsyncSession
---------------------
+----------------------------------------
 When querying the base type in multi-table inheritance or joined table inheritance, you can only directly refer to polymorphic fields when they are loaded eagerly.
 This restricting is in place because AsyncSessions don't allow implicit async operations such as the loads of the joined tables.
 To load the polymorphic fields eagerly, you can use the `with_polymorphic` attribute of the mapper args in the base model:
 
 .. code:: python
+
     class Person(Base):
         id = Column(Integer(), primary_key=True)
         type = Column(String())

docs/relay.rst

@@ -1,5 +1,5 @@
 Relay
-====
+==========
 
 :code:`graphene-sqlalchemy` comes with pre-defined
 connection fields to quickly create a functioning relay API.

docs/starter.rst

@@ -1,5 +1,5 @@
 Getting Started
-====
+=================
 
 Welcome to the graphene-sqlalchemy documentation!
 Graphene is a powerful Python library for building GraphQL APIs,
@@ -80,7 +80,7 @@ Then you can simply query the schema:
 
 
 It is important to provide a session for graphene-sqlalchemy to resolve the models.
-In this example, it is provided using the GraphQL context. See :ref:`querying` for
+In this example, it is provided using the GraphQL context. See :doc:`tips` for
 other ways to implement this.
 
 You may also subclass SQLAlchemyObjectType by providing