Apply suggestions from code review

Co-authored-by: Shati Patel <[email protected]>

Author: jf205

docs/ql-style-guide.md

@@ -214,7 +214,7 @@ class Type extends ... {
 
 ## Documentation
 
-For more information about documenting the code that you contribute to this repository, see the [QLDoc style guide](ql-doc-style-guide.md).
+For more information about documenting the code that you contribute to this repository, see the [QLDoc style guide](qldoc-style-guide.md).
 
 ## Formulas
 1. *Prefer* one *conjunct* per line.

docs/qldoc-style-guide.md

@@ -43,7 +43,7 @@ Valid QL comments are known as QLDoc. This document describes the recommended st
 
 ### Predicates without result
 
-1. Document predicates that do not have using a third-person verb phrase of the form ``Holds if `arg` has <property>.``.
+1. Use a third-person verb phrase of the form ``Holds if `arg` has <property>.``.
 1. Avoid:
    - `/**Whether ...*/`
    - `/**"Relates ...*/`
@@ -63,7 +63,7 @@ Valid QL comments are known as QLDoc. This document describes the recommended st
 
 ### Predicates with result
 
-1. Document predicates that have a result using a third-person verb phrase of the form `Gets (a|the) <thing>`.
+1. Use a third-person verb phrase of the form `Gets (a|the) <thing>`.
 1. Use "if any" if the item is usually unique, but might be missing. For example
 `Gets the body of this method, if any.`.
 1. If the predicate has more complex behaviour, for example multiple arguments are conceptually "outputs", it can be described like a predicate without a result. For example
@@ -117,15 +117,15 @@ Certain special predicates should be documented consistently.
   string toString() { ... } 
   ```
 
-- Always document `hasLocationInfo` be documented like this:
+- Always document `hasLocationInfo` as
 
   ```ql
   /**
    * Holds if this element is at the specified location.
    * The location spans column `startcolumn` of line `startline` to
    * column `endcolumn` of line `endline` in file `filepath`.
    * For more information, see
-   * [Locations](https://help.semmle.com/QL/learn-ql/ql/locations.html).
+   * [Locations](https://help.semmle.com/QL/learn-ql/locations.html).
    */
 
   predicate hasLocationInfo(string filepath, int startline, int startcolumn, int endline, int endcolumn) { ... }