Very basic usage info.

Author: Julian

docs/index.rst

@@ -2,6 +2,23 @@
 
 Resources are exposed via a `referencing.Registry`.
 
+Usage
+-----
+
+There is essentially one main object provided, `jsonschema_specifications.REGISTRY`, which is a `referencing.Registry` (or more specifically a `referencing.jsonschema.SchemaRegistry`) containing all of the "official" JSON Schemas.
+
+For full details on using it, see the `referencing documentation <referencing:intro>`, but for example:
+
+.. code::
+
+    from jsonschema_specifications import REGISTRY as SPECIFICATIONS
+
+    DRAFT202012_DIALECT_URI = "https://json-schema.org/draft/2020-12/schema"
+    print(SPECIFICATIONS.contents(DRAFT202012_DIALECT_URI))
+
+    # -> prints the Draft 2020-12 meta-schema
+
+
 Contents
 --------
 

pyproject.toml

@@ -43,6 +43,11 @@ Issues = "https://github.com/python-jsonschema/jsonschema-specifications/issues/
 Funding = "https://github.com/sponsors/Julian"
 Source = "https://github.com/python-jsonschema/jsonschema-specifications"
 
+[tool.doc8]
+ignore = [
+    "D001",  # one sentence per line, so max length doesn't make sense
+]
+
 [tool.isort]
 combine_as_imports = true
 from_first = true