From 7eb79006f9a4c5b8822161123bb2efb8347ff348 Mon Sep 17 00:00:00 2001
From: Carlton Gibson <carlton.gibson@noumenal.es>
Date: Thu, 14 Sep 2017 10:10:31 +0200
Subject: [PATCH] Add package/module docstrings

---
 rest_framework/schemas/__init__.py   | 33 ++++++++++++++++++----------
 rest_framework/schemas/generators.py |  5 +++++
 rest_framework/schemas/inspectors.py |  5 +++++
 rest_framework/schemas/utils.py      |  5 +++++
 rest_framework/schemas/views.py      |  5 +++++
 5 files changed, 42 insertions(+), 11 deletions(-)

diff --git a/rest_framework/schemas/__init__.py b/rest_framework/schemas/__init__.py
index d69925bca69..fc551640e76 100644
--- a/rest_framework/schemas/__init__.py
+++ b/rest_framework/schemas/__init__.py
@@ -1,14 +1,25 @@
-# We expose a minimal "public" API directly from `schemas`. This covers the
-# basic use-cases:
-#
-#     from rest_framework.schemas import (
-#         AutoSchema,
-#         ManualSchema,
-#         get_schema_view,
-#         SchemaGenerator,
-#     )
-#
-# Other access should target the submodules directly
+"""
+rest_framework.schemas
+
+schemas:
+    __init__.py
+    generators.py   # Top-down schema generation
+    inspectors.py   # Per-endpoint view introspection
+    utils.py        # Shared helper functions
+    views.py        # Houses `SchemaView`, `APIView` subclass.
+
+We expose a minimal "public" API directly from `schemas`. This covers the
+basic use-cases:
+
+    from rest_framework.schemas import (
+        AutoSchema,
+        ManualSchema,
+        get_schema_view,
+        SchemaGenerator,
+    )
+
+Other access should target the submodules directly
+"""
 from .generators import SchemaGenerator
 from .inspectors import AutoSchema, ManualSchema  # noqa
 
diff --git a/rest_framework/schemas/generators.py b/rest_framework/schemas/generators.py
index eeea9d70987..8344f64f0e6 100644
--- a/rest_framework/schemas/generators.py
+++ b/rest_framework/schemas/generators.py
@@ -1,3 +1,8 @@
+"""
+generators.py   # Top-down schema generation
+
+See schemas.__init__.py for package overview.
+"""
 from collections import OrderedDict
 from importlib import import_module
 
diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py
index b1dae678f19..cd9fa73da9f 100644
--- a/rest_framework/schemas/inspectors.py
+++ b/rest_framework/schemas/inspectors.py
@@ -1,3 +1,8 @@
+"""
+inspectors.py   # Per-endpoint view introspection
+
+See schemas.__init__.py for package overview.
+"""
 import re
 from collections import OrderedDict
 
diff --git a/rest_framework/schemas/utils.py b/rest_framework/schemas/utils.py
index b82c6585a7e..1542b6154bc 100644
--- a/rest_framework/schemas/utils.py
+++ b/rest_framework/schemas/utils.py
@@ -1,3 +1,8 @@
+"""
+utils.py        # Shared helper functions
+
+See schemas.__init__.py for package overview.
+"""
 
 
 def is_list_view(path, method, view):
diff --git a/rest_framework/schemas/views.py b/rest_framework/schemas/views.py
index d01877872b1..932b5a48710 100644
--- a/rest_framework/schemas/views.py
+++ b/rest_framework/schemas/views.py
@@ -1,3 +1,8 @@
+"""
+views.py        # Houses `SchemaView`, `APIView` subclass.
+
+See schemas.__init__.py for package overview.
+"""
 from rest_framework import exceptions, renderers
 from rest_framework.response import Response
 from rest_framework.settings import api_settings