Fixing comments

pkg/yqlib/doc/comment-operators.md

@@ -139,7 +139,7 @@ will output
 welcome!
 ```
 
-## 
+## Head comment with document split
 Given a sample.yml file of:
 ```yaml
 # welcome!

pkg/yqlib/doc/headers/parent.md

@@ -0,0 +1,3 @@
+# Parent
+
+Parent simply returns the parent nodes of the matching nodes.

pkg/yqlib/doc/parent.md

@@ -1,3 +1,6 @@
+# Parent
+
+Parent simply returns the parent nodes of the matching nodes.
 
 ## Simple example
 Given a sample.yml file of:
@@ -14,13 +17,15 @@ will output
 nested: cat
 ```
 
-## Show parent
+## Parent of nested matches
 Given a sample.yml file of:
 ```yaml
 a:
   fruit: apple
+  name: bob
 b:
   fruit: banana
+  name: sam
 ```
 then
 ```bash
@@ -29,6 +34,7 @@ yq eval '.. | select(. == "banana") | parent' sample.yml
 will output
 ```yaml
 fruit: banana
+name: sam
 ```
 
 ## No parent