.. _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

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

Finding the right documentation resources
-----------------------------------------

Bokeh's documentation consists of several components:

.. panels::
    :container: container-fluid pb-3
    :column: col-lg-4 col-md-4 col-sm-12 col-xs-12 p-2

    :header: bg-bokeh-one

    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.

    ---
    :header: bg-bokeh-two
    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.

    ---
    :header: bg-bokeh-three
    If you need more advanced information
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

    Get to know every aspect of Bokeh:

    * :ref:`refguide`: detailed information about all of Bokeh's components

    * :ref:`devguide`: 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 `Twitter`_, `Medium`_, and
`LinkedIn`_.


.. panels::
    :body: bokeh-examples
    :container: container-fluid pb-3 examples-container
    :column: col-lg-1 col-md-1 col-sm-2 col-xs-4 p-2

    .. image:: /_images/thumbs/image_t.png
       :target: docs/gallery/image.html
       :alt: Thumbnail for image example
    ---
    .. image:: /_images/thumbs/anscombe_t.png
       :target: docs/gallery/anscombe.html
       :alt: Thumbnail for Anscombe's quartet example
    ---
    .. image:: /_images/thumbs/stocks_t.png
       :target: docs/gallery/stocks.html
       :alt: Thumbnail for stocks example
    ---
    .. image:: /_images/thumbs/lorenz_t.png
       :target: docs/gallery/lorenz.html
       :alt: Thumbnail for Lorenz attractor example
    ---
    .. image:: /_images/thumbs/candlestick_t.png
       :target: docs/gallery/candlestick.html
       :alt: Thumbnail for candlestick example
    ---
    .. image:: /_images/thumbs/scatter_t.png
       :target: docs/gallery/color_scatter.html
       :alt: Thumbnail for color scatter example
    ---
    .. image:: /_images/thumbs/les_mis_t.png
       :target: docs/gallery/les_mis.html
       :alt: Thumbnail for Les Mis occurrences example
    ---
    .. image:: /_images/thumbs/histogram_t.png
       :target: docs/gallery/histogram.html
       :alt: Thumbnail for histogram example
    ---
    .. image:: /_images/thumbs/iris_t.png
       :target: docs/gallery/iris.html
       :alt: Thumbnail for iris morphology example
    ---
    .. image:: /_images/thumbs/choropleth_t.png
       :target: docs/gallery/texas.html
       :alt: Thumbnail for choropleth example
    ---
    .. image:: /_images/thumbs/splom_t.png
       :target: docs/gallery/iris_splom.html
       :alt: Thumbnail for iris example
    ---
    .. image:: /_images/thumbs/burtin_t.png
       :target: docs/gallery/burtin.html
       :alt: Thumbnail for Burtin example


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

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

.. _Interactive tutorial notebooks: https://mybinder.org/v2/gh/bokeh/bokeh-notebooks/master?filepath=tutorial%2F00%20-%20Introduction%20and%20Setup.ipynb
.. _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
.. _Twitter: https://twitter.com/bokeh
.. _Medium: https://medium.com/bokeh
.. _LinkedIn: https://www.linkedin.com/company/project-bokeh/
