[docs] Add typing info to quick start

AUTHORS

@@ -12,8 +12,10 @@ Adrian Tejn Kern <[email protected]>
 Andrew Schaaf <[email protected]>
 Danilo de Jesus da Silva Bellini <[email protected]>
 David LaPalomento <[email protected]>
+dvogel <[email protected]>
 Filip Noetzel <[email protected]>
 Gary van der Merwe <[email protected]>
+gfxmonk <[email protected]>
 Gora Khargosh <[email protected]>
 Hannu Valtonen <[email protected]>
 Jesse Printz <[email protected]>
@@ -25,6 +27,7 @@ Malthe Borch <[email protected]>
 Martin Kreichgauer <[email protected]>
 Martin Kreichgauer <[email protected]>
 Mike Lundy <[email protected]>
+Nicholas Hairs <[email protected]>
 Raymond Hettinger <[email protected]>
 Roman Ovchinnikov <[email protected]>
 Rotem Yaari <[email protected]>
@@ -43,9 +46,6 @@ Todd Whiteman <[email protected]>
 Will McGugan <[email protected]>
 Yesudeep Mangalapilly <[email protected]>
 Yesudeep Mangalapilly <[email protected]>
-dvogel <[email protected]>
-gfxmonk <[email protected]>
-
 
 We would like to thank these individuals for ideas:
 ---------------------------------------------------

docs/source/quickstart.rst

@@ -52,3 +52,22 @@ file system changes and simply print them to the console::
         observer.join()
 
 To stop the program, press Control-C.
+
+Typing
+------
+If you are using type annotations it is important to note that
+`watchdog.observers.Observer` is not actually a class; it is a variable that
+hold the "best" observer class available on your platform.
+
+In order to correctly type your own code your should use
+`watchdog.observers.api.BaseObserver`. For example:
+
+    from watchdog.observers import Observer
+    from watchdog.observers.api import BaseObserver
+
+    def my_func(o: BaseObserver) -> None:
+        # Do something with o
+        return
+
+    observer: BaseObserver = Observer()
+    my_func(observer)