Reference Guide should link to Users Guide where appropriate.

[bryevdv]

E.g. the Slope reference guide entry could link to the "Adding Anotations" User Guide section for a more complete discussion.

[santos22]

I can look into this. Looks like the labels might be off by one. Should I create an issue? Or I could fix this as part of this issue.

In the source, the following should be .. _userguide_plotting_slope: and not .. _userguide_plotting_spans:.

Slopes
------

|Slope| annotations are lines which may be sloped and extend to the
edge of the plot area.

.. bokeh-plot:: docs/user_guide/examples/plotting_slope.py
    :source-position: above

.. _userguide_plotting_spans:

Source: https://raw.githubusercontent.com/bokeh/bokeh/master/sphinx/source/docs/user_guide/annotations.rst

[santos22]

@bryevdv

[santos22]

Whoops. I wasn't using the label correctly. The previous comment can be ignored.

I will work on linking reference guide entries to the following entries in the user guide:

• Titles
• Legends
• Color Bars
• Arrows
• Bands
• Box Annotations
• Labels
• Slopes
• Spans
• Whiskers

[bryevdv]

@santos22 FYI generally no need to "ping" people everyone here is a volunteer with their own individual schedules and time commitments. OSS issue/PR cycles will often takes days, sometimes weeks, and occasionally longer. Someone will get to things in due time :)

[bryevdv]

Going to leave this issue open as an "evergreen" GFI for adding more linkages between user guide and ref guide

[Med16-11]

Hello @bryevdv @tcmetzger I am an Outreachy applicant and would like to work on this issue.