diff --git a/website/source/api/json-jobs.html.md b/website/source/api/json-jobs.html.md
index 78ce4aaf3..dc2477762 100644
--- a/website/source/api/json-jobs.html.md
+++ b/website/source/api/json-jobs.html.md
@@ -725,6 +725,9 @@ The `Constraint` object supports the following keys:
 
 ### Affinity
 
+Affinities allow operators to express placement preferences. More details on how they work
+are described in [affinities](/docs/job-specification/affinity.html)
+
 The `Affinity` object supports the following keys:
 
 - `LTarget` - Specifies the attribute to examine for the
diff --git a/website/source/docs/job-specification/affinity.html.md b/website/source/docs/job-specification/affinity.html.md
index 2b52398e3..56f7a6c5f 100644
--- a/website/source/docs/job-specification/affinity.html.md
+++ b/website/source/docs/job-specification/affinity.html.md
@@ -229,7 +229,7 @@ affinity {
 Operators can run `nomad alloc status -verbose` to get more detailed information on various
 factors, including affinities that affect the final placement.
 
-#### Example Placement Metadata ####
+#### Example Placement Metadata
 The following is a snippet from the CLI output of `nomad alloc status -verbose <alloc-id>` showing scoring metadata.
 
 ```