Remove cheat sheet.

The information wasn't presented in a useful format and some of it
was out of date.

Refs #1209.

Author: aaugustin

docs/faq/common.rst

@@ -3,6 +3,33 @@ Both sides
 
 .. currentmodule:: websockets.asyncio.connection
 
+.. _enable-debug-logs:
+
+How do I enable debug logs?
+---------------------------
+
+You can enable debug logs to see exactly what websockets is doing.
+
+If logging isn't configured in your application::
+
+    import logging
+
+    logging.basicConfig(
+        format="%(asctime)s %(message)s",
+        level=logging.DEBUG,
+    )
+
+If logging is already configured::
+
+    import logging
+
+    logger = logging.getLogger("websockets")
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(logging.StreamHandler())
+
+Refer to the :doc:`logging documentation <../topics/logging>` for more details
+on logging in websockets.
+
 What does ``ConnectionClosedError: no close frame received or sent`` mean?
 --------------------------------------------------------------------------
 
@@ -39,8 +66,9 @@ There are several reasons why long-lived connections may be lost:
   connections may terminate connections after a short amount of time, usually
   30 seconds, despite websockets' keepalive mechanism.
 
-If you're facing a reproducible issue, :ref:`enable debug logs <debugging>` to
-see when and how connections are closed.
+If you're facing a reproducible issue, :ref:`enable debug logs
+<enable-debug-logs>` to see when and how connections are closed. connections are
+closed.
 
 What does ``ConnectionClosedError: sent 1011 (internal error) keepalive ping timeout; no close frame received`` mean?
 ---------------------------------------------------------------------------------------------------------------------

docs/faq/index.rst

@@ -7,10 +7,14 @@ Frequently asked questions
     about :mod:`asyncio`.
     :class: seealso
 
-    Python's documentation about `developing with asyncio`_ is a good
-    complement.
+    If you're new to ``asyncio``, you will certainly encounter issues that are
+    related to asynchronous programming in general rather than to websockets in
+    particular.
 
-    .. _developing with asyncio: https://docs.python.org/3/library/asyncio-dev.html
+    Fortunately, Python's official documentation provides advice to `develop
+    with asyncio`_. Check it out: it's invaluable!
+
+    .. _develop with asyncio: https://docs.python.org/3/library/asyncio-dev.html
 
 .. toctree::
 

docs/howto/cheatsheet.rst

@@ -21,7 +21,6 @@ If you're stuck, perhaps you'll find the answer here.
 .. toctree::
    :titlesonly:
 
-   cheatsheet
    patterns
    autoreload
 

docs/howto/index.rst

@@ -72,7 +72,7 @@ Here's a basic configuration for a server in production::
 Here's how to enable debug logs for development::
 
     logging.basicConfig(
-        format="%(message)s",
+        format="%(asctime)s %(message)s",
         level=logging.DEBUG,
     )