[Docs] Consistently refer to either `codeql-pack.yml` or `qlpack.yml`

[Marcono1234]

Description of the issue

Apparently codeql-pack.yml and qlpack.yml are equivalent:

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

Line 67 in 3674966

``codeql-pack.yml`` is an alias for ``qlpack.yml``.

This might be a source of confusion, so it would be good to at least consistently refer to this file only by one name¹ (except for the specification mentioned above). Here are cases where codeql-pack.yml is currently used:

• github/codeql

  • codeql/docs/codeql/codeql-language-guides/customizing-library-models-for-actions.rst

    Line 71 in 3674966

    2. Create a model pack file ``/codeql-pack.yml`` with the following content:

  • ...?
• github/docs
  • https://github.com/github/docs/blob/5f66400982b48a0f97b4dd2c85bb2677edd09206/content/code-security/code-scanning/managing-your-code-scanning-configuration/editing-your-configuration-of-default-setup.md?plain=1#L75
  • ...?
• github/vscode-codeql
  • Generate qlpack.yml instead of codeql-pack.yml? vscode-codeql#4104

Additionally it might be good to mention in https://docs.github.com/en/code-security/codeql-cli/using-the-advanced-functionality-of-the-codeql-cli/publishing-and-using-codeql-packs#about-qlpackyml-files that codeql-pack.yml is an alias.

What do you think?

Footnotes

1. If the canonical name is qlpack.yml, then maybe prefer that, except that the lock file is named codeql-pack.lock.yml ... ↩

[hvitved]

Hi

I agree that it would be good to consistently use one of the two, I'll ping the relevant team, but I don't know if it will be prioritized.

[hvitved]

CC @oscarsj for prioritization.