Docs 202109 (#1067)

* module docstrings

* db schema graph

* dev docs first pass

* dev docs pass 2

* add generated notification to top of generated docs files

* linting

* regen docs

Co-authored-by: Stefan Pratter <stefan@20c.com>
Co-authored-by: Sunshine Buchholz <sunshine@20c.com>

peeringdb_server/search.py

@@ -1,3 +1,13 @@
+"""
+Search implementation used for the peeringdb top search bar, name
+searches through the api `name_search` filter, as well as advanced
+search functionality.
+
+Search logic is handled by django-haystack and whoosh.
+
+Refer to search_indexes.py for search index definition.
+"""
+
 # import time
 import unidecode
 from django.conf import settings
@@ -86,9 +96,9 @@ def make_autocomplete_query(term):
 
 def search(term, autocomplete=False):
     """
-    Search searchable objects (ixp, network, facility ...) by term
+    Search searchable objects (ixp, network, facility ...) by term.
 
-    Returns result dict
+    Returns result dict.
     """
 
     # t0 = time.time()