Apply suggestions from code review

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

Author: jf205

docs/codeql/ql-language-reference/index.rst

@@ -35,7 +35,7 @@ Learn all about QL, the powerful query language that underlies the code scanning
 
 - :doc:`QL language specification <ql-language-specification>`: A formal specification for the QL language. It provides a comprehensive reference for terminology, syntax, and other technical details about QL. 
 
-- :doc:`QLDoc comment specification <qldoc-comment-specification>`: a formal specification for QLDoc comments.
+- :doc:`QLDoc comment specification <qldoc-comment-specification>`: A formal specification for QLDoc comments.
 
 .. toctree::
    :maxdepth: 1
@@ -56,4 +56,4 @@ Learn all about QL, the powerful query language that underlies the code scanning
    name-resolution
    evaluation-of-ql-programs
    ql-language-specification
-   qldoc-comment-specification
+   qldoc-comment-specification

docs/codeql/writing-codeql-queries/index.rst

@@ -5,12 +5,12 @@ Writing CodeQL queries
 
 Get to know more about queries and learn some key query-writing skills by solving puzzles.
 
-- :ref:`CodeQL <codeql-queries>`: CodeQL queries are used in code scanning analyses to find problems in source code, including potential security vulnerabilities.
+- :ref:`CodeQL queries <codeql-queries>`: CodeQL queries are used in code scanning analyses to find problems in source code, including potential security vulnerabilities.
 
 - :ref:`QL tutorials <ql-tutorials>`: Solve puzzles to learn the basics of QL before you analyze code with CodeQL. The tutorials teach you how to write queries and introduce you to key logic concepts along the way.
 
 .. toctree::
    :hidden:
 
    ql-tutorials/index
-   codeql-queries/index
+   codeql-queries/index