update several intros

james · james · commit ce1082dc5544 · 2020-11-12T11:12:55.000Z
diff --git a/docs/codeql/codeql-cli/codeql-cli-reference/index.rst b/docs/codeql/codeql-cli/codeql-cli-reference/index.rst
@@ -3,8 +3,7 @@
 CodeQL CLI reference
 ====================
 
-Find detailed information about the CodeQL commands, as well the files you can
-use or generate when executing CodeQL processes. 
+Learn more about the files you can use when running CodeQL processes and the results format and exit codes that CodeQL generates. 
 
 .. toctree::
    :titlesonly:
diff --git a/docs/codeql/codeql-cli/index.rst b/docs/codeql/codeql-cli/index.rst
@@ -10,7 +10,9 @@ See the following links to learn how to get set up and run CodeQL commands:
 - :ref:`Using the CodeQL CLI <using-the-codeql-cli>`: Software 
   developers and security researchers can secure their code using the CodeQL CLI.
 
-- :ref:`CodeQL CLI reference <codeql-cli-reference>`."
+- :ref:`CodeQL CLI reference <codeql-cli-reference>`: Learn more about the files you can use when running CodeQL processes and the results format and exit codes that CodeQL generates.
+
+- `CodeQL CLI manual <codeql-cli-manual>`__: Detailed information about all the commands available with the CodeQL CLI.
 
 .. toctree::
    :titlesonly:
diff --git a/docs/codeql/index.rst b/docs/codeql/index.rst
@@ -5,8 +5,9 @@ CodeQL documentation
    :hidden:
    
    codeql-overview/index
+   codeql-for-visual-studio-code/index
+   codeql-cli/index
    writing-codeql-queries/index
    codeql-language-guides/index
    ql-language-reference/index
-   codeql-for-visual-studio-code/index
-   codeql-cli/index
+
