Frequently asked questions
==========================

.. currentmodule:: websockets

.. admonition:: Many questions asked in websockets' issue tracker are really
    about :mod:`asyncio`.
    :class: seealso

    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.

    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::

    server
    client
    common
    asyncio
    misc
