issue_comments

Spotted a rogue backtick:

Adding type signatures to create_table() and .create_table_sql() is a bit too involved, I'll do that in a separate issue.

That worked! https://sqlite-utils.datasette.io/en/autodoc/reference.html

From https://docs.readthedocs.io/en/stable/config-file/v2.html#packages it looks like I can tell Read The Docs to run pip install -e . using a .readthedocs.yaml configuration:

```yaml version: 2

sphinx: configuration: docs/conf.py

python: version: "3.9" install: - method: pip path: . extra_requirements: - docs ```

Reading the rest of https://sphinx-rtd-tutorial.readthedocs.io/en/latest/sphinx-config.html#autodoc-configuration it suggests using a requirements.txt file to install dependencies - but I use setup.py for that so I need to figure out a different pattern here.

https://sphinx-rtd-tutorial.readthedocs.io/en/latest/sphinx-config.html#autodoc-configuration says do something like this at the top of conf.py:

python import os import sys sys.path.insert(0, os.path.abspath('../../simpleble/'))

Docs are now building at https://sqlite-utils.datasette.io/en/autodoc/reference.html

But there's a problem! The page is semi-blank:

I need to teach Read The Docs how to ensure sqlite_utils is available for introspection.

I'm going to get Read The Docs to build the docs for this branch too - on https://readthedocs.org/projects/sqlite-utils/versions/ I am clicking this button:

I then set it to "active" (so pushes to the branch will build it) and "hidden" (so it wouldn't show up in search or in the navigation menu). https://docs.readthedocs.io/en/stable/versions.html#version-states

On Python 3.6:

sqlite_utils/db.py:366: in Database def tables(self) -> List[Table]: E NameError: name 'Table' is not defined Python 3.7 can fix this with from __future__ import annotations but since we still support 3.6 I'll have to use a string instead.