diff --git a/docs/codeql/codeql-cli/about-codeql-packs.rst b/docs/codeql/codeql-cli/about-codeql-packs.rst index 8bc20dd50b8..e1fca697982 100644 --- a/docs/codeql/codeql-cli/about-codeql-packs.rst +++ b/docs/codeql/codeql-cli/about-codeql-packs.rst @@ -67,7 +67,7 @@ The following properties are supported in ``qlpack.yml`` files. - All packs - A version number for this CodeQL pack. This must be a valid semantic version that meets the `SemVer v2.0.0 specification `__. * - ``dependencies`` - - ``codeql/javascript-all: 1.2.3`` + - ``codeql/javascript-all: ^1.2.3`` - Optional - The names of any CodeQL packs that this pack depends on, as a sequence. This gives the pack access to any libraries, database schema, and query suites defined in the dependency. Optionally a version for the dependency is specified. * - ``suites`` diff --git a/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst b/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst index 15f8caee812..4f35cb90b87 100644 --- a/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst +++ b/docs/codeql/codeql-cli/creating-and-working-with-codeql-packs.rst @@ -42,7 +42,7 @@ Modifying an existing QL pack to create a CodeQL pack ----------------------------------------------------- If you already have a ``qlpack.yml`` file, you can edit it manually to convert it into a CodeQL pack. -#. Edit the ``name`` property so that it matches the format ``/``, where ```` is the name of the GitHub organization that you will publish to. +#. Edit the ``name`` property so that it matches the format ``/``, where ```` is the name of the GitHub organization or user account that you will publish to. #. In the ``qlpack.yml`` file, include a ``version`` property with a semver identifier, as well as an optional ``dependencies`` block. For more information about the properties, see ":ref:`About CodeQL packs `." @@ -55,7 +55,7 @@ You can add dependencies on CodeQL packs using the command ``codeql pack add``. codeql pack add /@x.x.x / -The version number is optional. If you leave off the version number, the latest version will be added. +The version range is optional. If you leave off the version range, the latest version will be added. Otherwise, the latest version that satisfies the requested range will be added. This command updates the ``qlpack.yml`` file with the requested dependencies and downloads them into the package cache. Please note that this command will reformat the file and remove all comments. diff --git a/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst b/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst index f9e250423fc..7399dc4c905 100644 --- a/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst +++ b/docs/codeql/codeql-cli/publishing-and-using-codeql-packs.rst @@ -26,7 +26,7 @@ You can check and modify the configuration details of your CodeQL pack prior to - query: default-suite-file: default-queries.qls # a pointer to a query-suite in this pack license: # optional, the license under which the pack is published - dependencies: + dependencies: # map from CodeQL pack name to version range - ``name:`` must follow the / format, where is the GitHub organization that you will publish to and is the name for the pack. - Only one of ``default-suite`` or ``default-suite-file`` is allowed. Both options define a default query suite to be run, the first by specifying queries directly in the `qlpack.yml` file and the second by specifying a query suite in the pack.