[query/ggplot] Updates API reference to include faceting (#12569)

hail/python/hail/docs/ggplot/index.rst

@@ -62,7 +62,7 @@ currently uses plotly to generate plots, as opposed to ``hl.plot``, which uses b
 .. rubric:: Scales
 
 .. autosummary::
-    :nosignatures
+    :nosignatures:
 
     scale_x_continuous
     scale_x_discrete
@@ -104,6 +104,19 @@ currently uses plotly to generate plots, as opposed to ``hl.plot``, which uses b
 .. autofunction:: scale_fill_manual
 .. autofunction:: scale_fill_identity
 
+
+.. rubric:: Facets
+
+.. autosummary::
+    :nosignatures:
+
+    facet_wrap
+    vars
+
+.. autofunction:: facet_wrap
+.. autofunction:: vars
+
+
 .. rubric:: Labels
 
 .. autosummary::
@@ -121,4 +134,4 @@ currently uses plotly to generate plots, as opposed to ``hl.plot``, which uses b
 
 .. autoclass:: GGPlot
 .. autoclass:: Aesthetic
-.. autoclass:: FigureAttribute
+.. autoclass:: FigureAttribute

hail/python/hail/ggplot/facets.py

@@ -15,12 +15,12 @@ def vars(*args: Expression) -> StructExpression:
 
     Parameters
     ----------
-    *args: class:`.Expression`
+    *args: :class:`hail.expr.Expression`
         Fields to facet by.
 
     Returns
     -------
-    :class:`StructExpression`
+    :class:`hail.expr.StructExpression`
         A struct to pass to a faceter.
 
     """
@@ -32,7 +32,7 @@ def facet_wrap(facets: StructExpression, *, nrow: int = None, ncol: int = None,
 
     Parameters
     ----------
-    facets: :class:`StructExpression` created by `hl.ggplot.vars` function.
+    facets: :class:`hail.expr.StructExpression` created by `hl.ggplot.vars` function.
         The fields to facet on.
     nrow: :class:`int`
         The number of rows into which the facets will be spread. Will be ignored if `ncol` is set.