add some comments to the doc conf.py just to clarify some changes

docs/conf.py

@@ -29,6 +29,7 @@
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.doctest',
+    # this plugin is used to format our markdown correctly
     'recommonmark',
     # uncomment the next line if you are writing in Google Napoleon docstrings
     # 'sphinx.ext.napoleon'
@@ -283,6 +284,9 @@ def run_apidoc(_):
         '--module-first',
         '--output-dir',
         './api/modules',
+        # this is expected to be run from the `docs` directory.  Its possible
+        # to set it up to run from other places, but so far this has worked for
+        # us
         '../src/py-opentimelineio/opentimelineio',
     ] + ignore_paths