docs: simplify 'learning codeql' landing page

This commit is contained in:
james
2020-03-27 12:50:03 +00:00
parent 76f344638e
commit b4b1903642

View File

@@ -15,55 +15,13 @@ CodeQL is based on a powerful query language called QL. The following topics hel
If you've previously used QL, you may notice slight changes in terms we use to describe some important concepts. For more information, see our note about :doc:`Recent terminology changes <terminology-note>`.
.. toctree::
:hidden:
terminology-note
.. _getting-started:
Getting started
***************
If you are new to QL, start by looking at the following topics:
.. toctree::
:maxdepth: 1
introduction-to-ql
about-ql
beginner/ql-tutorials
CodeQL training and variant analysis examples
*********************************************
To start learning how to use CodeQL for variant analysis for code written in a specific language, see:
.. toctree::
:maxdepth: -1
ql-training
.. _writing-ql-queries:
Writing CodeQL queries
**********************
To learn more about writing your own queries, see:
.. toctree::
:maxdepth: 3
:includehidden:
writing-queries/writing-queries
For more information on using CodeQL to query code written in a specific language, see:
.. toctree::
:maxdepth: 2
:includehidden:
cpp/ql-for-cpp
csharp/ql-for-csharp
cobol/ql-for-cobol
@@ -71,29 +29,16 @@ For more information on using CodeQL to query code written in a specific languag
java/ql-for-java
javascript/ql-for-javascript
python/ql-for-python
Technical information
*********************
For more technical information see:
ql-training
technical-info
.. toctree::
:maxdepth: 2
:includehidden:
:hidden:
terminology-note
technical-info
Further reading
***************
Reference topics
****************
For a more comprehensive guide to the query language itself, see the following reference topics:
- `QL language handbook <https://help.semmle.com/QL/ql-handbook/index.html>`__—a description of important concepts in QL.
- `QL language specification <https://help.semmle.com/QL/ql-spec/language.html>`__—a formal specification of QL.
Search
******
.. * :ref:`genindex` remove index for the time being as we currently have no tags
* :ref:`search`
- `QL language handbook <https://help.semmle.com/QL/ql-handbook/index.html>`__: A description of important concepts in QL.
- `QL language specification <https://help.semmle.com/QL/ql-spec/language.html>`__: A formal specification of QL.