review comments

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

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