:notoc: :html_theme.sidebar_secondary.remove:

.. _about:

Bokeh documentation

Bokeh is a Python library for creating interactive visualizations for modern web browsers. It helps you build beautiful graphics, ranging from simple plots to complex dashboards with streaming datasets. With Bokeh, you can create JavaScript-powered visualizations without writing any JavaScript yourself.

.. raw:: html

<div>
    <form class="bd-search align-items-center" action="search.html" method="get">
      <input type="search" class="form-control search-front-page" name="q" id="search-input" placeholder="&#128269; Search the docs ..." aria-label="Search the docs ..." autocomplete="off">
    </form>
</div>

Finding the right documentation resources

Bokeh's documentation consists of several components:

.. grid:: 1 1 3 3

.. grid-item-card::

    If you are new to Bokeh
    ^^^
    Follow these guides to get started:

    * :ref:`first_steps`: simple tutorials that walk you through installing Bokeh and creating your first visualizations.

    * :ref:`userguide`: explanations of all key functionalities of Bokeh and how to use them. Includes several standalone examples.


.. grid-item-card::

    If you have some basic knowledge of Bokeh
    ^^^
    Learn more by exploring examples:

    * :ref:`gallery`: a collection of examples with source code.

    * `Interactive tutorial notebooks`_: a collection of interactive notebooks to experiment with all elements of Bokeh.

    * :ref:`userguide`: explanations of all key functionalities of Bokeh and how to use them, including examples.


.. grid-item-card::

    If you need more advanced information
    ^^^
    Get to know every aspect of Bokeh:

    * :ref:`Reference guide <refguide>`: detailed information about all of Bokeh's components.

    * :ref:`Contributor guide <contributor_guide>`: information on the various ways you can contribute to the Bokeh project.

Connecting with the Bokeh community

There are various ways to get in touch with the Bokeh community_:

The Bokeh Discourse_ is the best place to ask usage questions and is a great way to get feedback from other users on how to approach a problem.
Questions involving pandas or other libraries may find a wider audience by posting with the "bokeh" tag on Stack Overflow_.
If you think you've found a bug, or would like to request a feature, please report an issue at Bokeh's GitHub repository_.

You can also find more information about Bokeh on Medium, and LinkedIn.

.. toctree:: :maxdepth: 3 :hidden:

docs/first_steps
docs/user_guide
docs/gallery
docs/reference
docs/dev_guide
docs/releases

.. image:: images/bokeh-hero.png :width: 100% :alt: A collage of 36 thumbnails of Bokeh plots :target: gallery

.. _Interactive tutorial notebooks: https://github.com/bokeh/tutorial/ .. _Bokeh community: https://bokeh.org/community/ .. _Bokeh Discourse: https://discourse.bokeh.org .. _"bokeh" tag on Stack Overflow: https://stackoverflow.com/questions/tagged/bokeh .. _Bokeh's GitHub repository: https://github.com/bokeh/bokeh .. _Medium: https://medium.com/bokeh .. _LinkedIn: https://www.linkedin.com/company/project-bokeh/ .. _gallery: docs/gallery.html