diff --git a/docs/harfbuzz-docs.xml b/docs/harfbuzz-docs.xml
index 83d3c30..c2b2323 100644
--- a/docs/harfbuzz-docs.xml
+++ b/docs/harfbuzz-docs.xml
@@ -97,6 +97,11 @@
         <xi:include href="xml/hb-directwrite.xml"/>
       </chapter>
 
+      <chapter id="style-api">
+        <title>Style API</title>
+        <xi:include href="xml/hb-style.xml"/>
+      </chapter>
+
       <chapter id="subset-api">
         <title>Subset API</title>
         <xi:include href="xml/hb-subset.xml"/>
diff --git a/docs/harfbuzz-sections.txt b/docs/harfbuzz-sections.txt
index ace2c37..8160cf6 100644
--- a/docs/harfbuzz-sections.txt
+++ b/docs/harfbuzz-sections.txt
@@ -708,6 +708,12 @@
 </SECTION>
 
 <SECTION>
+<FILE>hb-style</FILE>
+hb_style_tag_t
+hb_style_get_value
+</SECTION>
+
+<SECTION>
 <FILE>hb-subset</FILE>
 hb_subset_flags_t
 hb_subset_input_t
diff --git a/src/hb-style.cc b/src/hb-style.cc
index 26042ae..b6f31b5 100644
--- a/src/hb-style.cc
+++ b/src/hb-style.cc
@@ -34,6 +34,15 @@
 #include "hb-ot-post-table.hh"
 #include "hb-ot-face.hh"
 
+/**
+ * SECTION:hb-style
+ * @title: hb-style
+ * @short_description: Font Styles
+ * @include: hb.h
+ *
+ * Functions for fetching style information from fonts.
+ **/
+
 static inline float
 _hb_angle_to_ratio (float a)
 {
@@ -52,7 +61,7 @@
  * @font: a #hb_font_t object.
  * @style_tag: a style tag.
  *
- * Searches variation axes of a hb_font_t object for a specific axis first,
+ * Searches variation axes of a #hb_font_t object for a specific axis first,
  * if not set, then tries to get default style values from different
  * tables of the font.
  *
diff --git a/src/hb-style.h b/src/hb-style.h
index 01e0218..54a3b59 100644
--- a/src/hb-style.h
+++ b/src/hb-style.h
@@ -44,6 +44,7 @@
  * must be greater than -90 and less than +90. Values can be interpreted as
  * the angle, in counter-clockwise degrees, of oblique slant from whatever the
  * designer considers to be upright for that font design.
+ * @HB_STYLE_TAG_SLANT_RATIO: same as @HB_STYLE_TAG_SLANT_ANGLE expression as ratio.
  * @HB_STYLE_TAG_WIDTH: Used to vary width of text from narrower to wider.
  * Non-zero. Values can be interpreted as a percentage of whatever the font
  * designer considers “normal width” for that font design.
@@ -52,7 +53,7 @@
  * comparison to values for usWeightClass in the OS/2 table,
  * or the CSS font-weight property.
  *
- * Defined by https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg
+ * Defined by [OpenType Design-Variation Axis Tag Registry](https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg).
  *
  * Since: REPLACEME
  **/