5f01af06ec
* Update beta-codeql-runner.md * Rename beta-codeql-runner.md to deprecation-codeql-runner.md * update reusable name * Update about-codeql-code-scanning-in-your-ci-system.md * Update running-codeql-code-scanning-in-a-container.md * Update uploading-a-sarif-file-to-github.md * Update sarif-support-for-code-scanning.md * Update running-codeql-runner-in-your-ci-system.md * Update configuring-codeql-cli-in-your-ci-system.md * Update configuring-codeql-runner-in-your-ci-system.md * Update running-codeql-runner-in-your-ci-system.md * Update content/github/finding-security-vulnerabilities-and-errors-in-your-code/using-codeql-code-scanning-with-your-existing-ci-system/troubleshooting-codeql-code-scanning-in-your-ci-system.md * Update configuring-codeql-cli-in-your-ci-system.md * Apply suggestions from code review Co-authored-by: Steve Guntrip <12534592+stevecat@users.noreply.github.com> * update codeql runner reusable * add new article about runner to cli migration * fix typo in new article title * Update deprecation-codeql-runner.md * Update deprecation-codeql-runner.md * Apply suggestions from code review * fix failing test * fix failing test * Update versioning to fix failing test * add `codeql-cli-binaries` to allow list Co-authored-by: James Fletcher <42464962+jf205@users.noreply.github.com> Co-authored-by: Felicity Chapman <felicitymay@github.com> Co-authored-by: Steve Guntrip <12534592+stevecat@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Reusables
Reusables are long strings of reusable text.
Reusables are longer strings like paragraphs or procedural lists that can be referenced in multiple content files. Using Markdown (instead of YAML) makes it possible for our localization pipeline to split the strings into smaller translatable segments, leading to fewer translation errors and less churn when the source English content changes.
Each reusable lives in its own Markdown file.
The path and filename of each Markdown file determines what its path will be in the data object.
For example, a file named /data/reusables/foo/bar.md will be accessible as {% data reusables.foo.bar %} in pages.
Reusable files are divided generally into directories by task. For example, if you're creating a reusable string for articles about GitHub notifications, you'd add it in the directory data/reusables/notifications/ in a file named data/reusables/notifications/your-reusable-name.md. The content reference you'd add to the source would look like {% data reusables.notifications.your-reusable-name %}.