forked from github/docs
-
Notifications
You must be signed in to change notification settings - Fork 2
/
product.yml
352 lines (297 loc) · 14.5 KB
/
product.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
# Contains versioned and unversioned variables for all of our product names
## WARNING: Versioned variables don't work as expected in articles under "content/enterprise/admin/". Use unversioned variables instead.
# Company
# Use this variable when referring to the company in the context of its business. For example, in licensing agreements
company_short: 'GitHub'
# GitHub's flagship products
## Use this variable to refer generically to the "GitHub" platform or website (for example, when referring to GitHub.com, GHEC, or GHES as simply "GitHub").
## Use another variable if it is important to specify the environment (e.g. GHES)
github: 'GitHub'
## DO NOT USE. Use the `github` variable instead. (Writers found the name of this variable to be misleading.)
prodname_dotcom: 'GitHub'
product_name: >-
{% ifversion ghec %}GitHub Enterprise Cloud{% elsif ghes %}GitHub Enterprise Server{% else %}GitHub{% endif %}
## Use this variable when the output should always be GitHub Enterprise, regardless of the product the user is using
prodname_enterprise: 'GitHub Enterprise'
## Use this variable only when the output should specifically be GitHub.com, to distinguish from GitHub the company or other GitHub products (e.g. connecting GHE to GitHub.com)
## Note that many users access GitHub through a different URL
## Do NOT use as a synonym for "The GitHub web interface" (for example, if you want to distinguish something from the GitHub Mobile interface), or in cases where the .com top-level domain is not relevant.
prodname_dotcom_the_website: 'GitHub.com'
## Use these variables when the output should reflect one of our two specific GitHub Enterprise offerings
prodname_ghe_server: 'GitHub Enterprise Server'
prodname_ghe_cloud: 'GitHub Enterprise Cloud'
prodname_ghe_one: 'GitHub One'
prodname_docs: 'GitHub Docs'
prodname_free_user: 'GitHub Free'
prodname_pro: 'GitHub Pro'
prodname_team: 'GitHub Team'
prodname_free_team: 'GitHub Free'
prodname_enterprise_backup_utilities: 'GitHub Enterprise Server Backup Utilities'
# GitHub Connect (enterprise accounts, other unified features)
prodname_github_connect: 'GitHub Connect'
# GitHub Enterprise Importer
prodname_importer_proper_name: 'GitHub Enterprise Importer'
prodname_importer_secondary_name: Importer
prodname_gei: GEI
prodname_gei_cli_short: GEI extension
prodname_gei_cli: GEI extension of the GitHub CLI
prodname_ado2gh: ADO2GH
prodname_ado2gh_cli: ADO2GH extension of the GitHub CLI
prodname_ado2gh_cli_short: ADO2GH extension
prodname_bbs2gh: BBS2GH
prodname_bbs2gh_cli: BBS2GH extension of the GitHub CLI
prodname_bbs2gh_cli_short: BBS2GH extension
# GitHub Education
prodname_education: 'GitHub Education'
prodname_education_community: 'Education Community'
prodname_education_community_with_url: 'the [GitHub Education Community](https://github.com/orgs/community/discussions/categories/github-education)'
prodname_education_forum_link: 'https://github.com/orgs/community/discussions/categories/github-education'
prodname_classroom: 'GitHub Classroom'
prodname_classroom_with_url: '[GitHub Classroom](https://classroom.github.com/login)'
prodname_campus_program: 'GitHub Campus Program'
prodname_student_pack: 'GitHub Student Developer Pack'
prodname_global_campus: 'GitHub Education'
prodname_community_exchange: 'GitHub Community Exchange'
prodname_student_leader_program: 'GitHub Campus Experts'
prodname_student_leader_program_singular: 'GitHub Campus Expert'
prodname_octernships: 'GitHub Octernships'
prodname_octernship_singular: 'GitHub Octernship'
prodname_certifications: 'GitHub Certifications'
prodname_certifications_singular: 'GitHub Certification'
# GitHub Expert Services
prodname_expert_services: 'GitHub Expert Services'
# GitHub CLI
prodname_cli: 'GitHub CLI'
# GitHub Desktop
prodname_desktop: 'GitHub Desktop'
desktop_link: 'https://desktop.github.com/'
# GitHub Mobile
prodname_mobile: 'GitHub Mobile'
prodname_ios: 'GitHub for iOS'
prodname_android: 'GitHub for Android'
# GitHub Pages
prodname_pages: 'GitHub Pages'
# CodeQL
prodname_codeql: 'CodeQL'
prodname_codeql_cli: 'CodeQL CLI'
# The CodeQL CLI version recommended for each GHES version.
# CodeQL usually bumps its minor version for each minor version of GHES.
# Update this whenever a new enterprise version of CodeQL is being prepared.
codeql_cli_ghes_recommended_version: >-
{% ifversion ghes < 3.11 %}2.13.5{% elsif ghes < 3.12 %}2.14.6{% elsif ghes < 3.13 %}2.15.5{% elsif ghes < 3.14 %}2.16.5{% elsif ghes < 3.15 %}2.17.6{% elsif ghes < 3.16 %}2.18.4{% endif %}
# Projects v2
prodname_projects_v2: 'Projects'
prodname_projects_v1: >-
projects (classic)
prodname_projects_v1_caps: >-
Projects (classic)
prodname_project_v1: >-
project (classic)
prodname_project_v1_caps: >-
Project (classic)
# Personal access tokens
pat_generic: 'personal access token'
pat_generic_plural: 'personal access tokens'
pat_generic_caps: 'Personal access token'
pat_generic_caps_plural: 'Personal access tokens'
pat_generic_title_case: 'Personal Access Token'
pat_generic_title_case_plural: 'Personal Access Tokens'
pat_v2: 'fine-grained personal access token'
pat_v2_plural: 'fine-grained personal access tokens'
pat_v2_caps: 'Fine-grained personal access token'
pat_v2_caps_plural: 'Fine-grained personal access tokens'
pat_v1: >-
{% ifversion pat-v2 %}personal access token (classic){% else %}personal access token{% endif %}
pat_v1_plural: >-
{% ifversion pat-v2 %}personal access tokens (classic){% else %}personal access tokens{% endif %}
pat_v1_caps: >-
{% ifversion pat-v2 %}Personal access token (classic){% else %}Personal access token{% endif %}
pat_v1_caps_plural: >-
{% ifversion pat-v2 %}Personal access tokens (classic){% else %}Personal access tokens{% endif %}
pat_classic: 'token (classic)'
pat_classic_plural: 'tokens (classic)'
pat_classic_caps: 'Token (classic)'
# Apps, GitHub Marketplace, and integrations
prodname_marketplace: 'GitHub Marketplace'
prodname_github_app: 'GitHub App'
prodname_github_apps: 'GitHub Apps'
prodname_oauth_app: 'OAuth app'
prodname_oauth_apps: 'OAuth apps'
prodname_github_models: 'GitHub Models'
# API and developer docs
prodname_enterprise_api: 'GitHub Enterprise Server APIs'
prodname_unfurls: 'Content Attachments'
# GitHub Actions
## Use this variable only when referring to GitHub Actions the product. When referring to the thing that someone creates using the product, call it an action (small a). See the terminology page of the Brand Guide for more.
prodname_actions: 'GitHub Actions'
prodname_actions_runner_controller: 'Actions Runner Controller'
runner_required_version: >-
{% ifversion ghes < 3.11 %}2.304.0{% elsif ghes < 3.12 %}2.309.0{% elsif ghes < 3.13 %}2.311.0{% elsif ghes < 3.14 %}2.314.1{% elsif ghes < 3.15 %}2.317.0{% elsif ghes < 3.16 %}2.319.1{% endif %}
# GitHub Debug
prodname_debug: 'GitHub Debug'
# GitHub Discussions
prodname_discussions: 'GitHub Discussions'
# GitHub Enterprise Managed Users
prodname_emu_idp_application: 'GitHub Enterprise Managed User'
prodname_emu_idp_oidc_application: 'GitHub Enterprise Managed User (OIDC)'
prodname_emus: 'Enterprise Managed Users'
prodname_emu: 'Enterprise Managed User'
# GitHub Issues
prodname_github_issues: 'GitHub Issues'
# GitHub Packages
prodname_registry: 'GitHub Packages'
prodname_container_registry: 'Container registry'
prodname_container_registries: 'Container registries'
prodname_docker_registry_namespace: '{% ifversion fpt or ghec %}`docker.pkg.github.com`{% elsif ghes %}<code>docker.<em>HOSTNAME</em></code>{% endif %}'
prodname_container_registry_namespace: '{% ifversion fpt or ghec %}`ghcr.io`{% elsif ghes %}<code>containers.<em>HOSTNAME</em></code>{% endif %}'
prodname_npm_registry: 'npm registry'
# GitHub Insights
prodname_insights: 'GitHub Insights'
# GitHub Sponsors
prodname_sponsors: 'GitHub Sponsors'
prodname_matching_fund: 'GitHub Sponsors Matching Fund'
# GitHub Advanced Security
prodname_GH_advanced_security: 'GitHub Advanced Security'
prodname_advanced_security: 'Advanced Security'
prodname_ghas_azdo: 'GitHub Advanced Security for Azure DevOps'
# Codespaces
prodname_codespaces: 'Codespaces'
prodname_github_codespaces: 'GitHub Codespaces'
# GitHub resources: blog, jobs, skills
prodname_gcf: 'GitHub Community Support'
prodname_github_community: 'GitHub Community'
prodname_blog: 'the GitHub Blog'
prodname_jobs: 'GitHub Jobs'
prodname_learning: 'GitHub Skills'
prodname_learning_link: 'https://skills.github.com/'
prodname_roadmap: 'GitHub public roadmap'
prodname_roadmap_link: 'https://github.com/github/roadmap#github-public-roadmap'
# GitHub support
premium_support_plan: 'Premium plan'
premium_plus_support_plan: 'Premium Plus plan / GitHub Engineering Direct'
microsoft_premium_plus_support_plan: 'GitHub Engineering Direct'
support_ticket_priority_urgent: 'Urgent'
support_ticket_priority_high: 'High'
support_ticket_priority_normal: 'Normal'
support_ticket_priority_low: 'Low'
# GitHub Professional Services
prodname_professional_services: 'GitHub Professional Services'
prodname_professional_services_team: 'Expert Services'
# GitHub Security Lab
prodname_security: 'GitHub Security Lab'
prodname_security_link: 'https://securitylab.github.com/'
# GitHub Security Advisories
prodname_security_advisories: 'GitHub Security Advisories'
prodname_advisory_database: 'GitHub Advisory Database'
# Security configurations and organization-level security settings
prodname_security_configurations: 'security configurations'
prodname_security_configurations_caps: 'Security configurations'
prodname_security_configuration: 'security configuration'
prodname_github_security_configuration: 'GitHub-recommended security configuration'
prodname_custom_security_configurations: 'custom security configurations'
prodname_custom_security_configuration: 'custom security configuration'
prodname_custom_security_configurations_caps: 'Custom security configurations'
prodname_custom_security_configuration_caps: 'Custom security configuration'
prodname_global_settings: 'global settings'
prodname_global_settings_caps: 'Global settings'
# Secret scanning
prodname_secret_scanning: 'secret scanning' # Overall feature name and name for GHES
prodname_secret_scanning_caps: 'Secret scanning'
# Code scanning
prodname_code_scanning: 'code scanning'
prodname_code_scanning_caps: 'Code scanning'
# Visual Studio
prodname_vs: 'Visual Studio'
# Visual Studio Code
prodname_vscode_shortname: 'VS Code'
prodname_vscode: 'Visual Studio Code'
prodname_vscode_command_palette_shortname: 'VS Code Command Palette'
prodname_vscode_command_palette: 'Visual Studio Code Command Palette'
prodname_vscode_marketplace: 'Visual Studio Code Marketplace'
prodname_vs_marketplace_shortname: 'VS Code Marketplace'
# GitHub Dependabot
prodname_dependabot: 'Dependabot'
prodname_dependabot_alerts: 'Dependabot alerts'
prodname_dependabot_security_updates: 'Dependabot security updates'
prodname_dependabot_version_updates: 'Dependabot version updates'
prodname_dependabot_updates: 'Dependabot updates'
# GitHub Archive Program
prodname_archive: 'GitHub Archive Program'
prodname_arctic_vault: 'Arctic Code Vault'
# GitHub Copilot (product)
prodname_copilot: 'GitHub Copilot'
prodname_copilot_short: 'Copilot'
prodname_copilot_for_business: 'GitHub Copilot Business'
prodname_copilot_for_individuals: 'GitHub Copilot Individual'
prodname_copilot_business_short: 'Copilot Business'
prodname_copilot_individuals_short: 'Copilot Individual'
prodname_copilot_enterprise: 'GitHub Copilot Enterprise'
prodname_copilot_enterprise_short: 'Copilot Enterprise'
prodname_copilot_chat: 'GitHub Copilot Chat'
prodname_copilot_chat_short: 'Copilot Chat'
prodname_copilot_chat_dotcom: 'GitHub Copilot Chat in GitHub'
prodname_copilot_chat_dotcom_short: 'Copilot Chat in GitHub'
prodname_copilot_mobile: 'GitHub Copilot Chat in GitHub Mobile'
prodname_copilot_mobile_short: 'Copilot Chat in GitHub Mobile'
prodname_copilot_extensions: 'GitHub Copilot Extensions'
prodname_copilot_extension: 'GitHub Copilot Extension'
prodname_copilot_extensions_short: 'Copilot Extensions'
prodname_copilot_extension_short: 'Copilot Extension'
prodname_copilot_extensions_vsc: 'Copilot-enabled Visual Studio Code extensions'
prodname_copilot_extension_vsc: 'Copilot-enabled Visual Studio Code extension'
prodname_copilot_agent: 'GitHub Copilot agent'
prodname_copilot_agent_short: 'Copilot agent'
prodname_copilot_agents: 'GitHub Copilot agents'
prodname_copilot_agents_short: 'Copilot agents'
prodname_copilot_cli: 'GitHub Copilot in the CLI'
prodname_copilot_cli_short: 'Copilot in the CLI'
prodname_copilot_for_prs: 'Copilot pull request summaries'
prodname_copilot_prs_short: 'pull request summaries'
prodname_copilot_customization: 'Copilot Customization'
prodname_copilot_in_support: 'Copilot in GitHub Support'
prodname_copilot_sku_isolation: 'Copilot subscription-based network routing'
prodname_copilot_autocomplete_pr: 'Copilot text completion'
# Copilot branded GHAS features
prodname_copilot_autofix: 'GitHub Copilot Autofix'
prodname_copilot_autofix_short: 'Copilot Autofix'
prodname_copilot_edits_vscode_short: 'Copilot Edits'
prodname_copilot_workspace_pr: 'GitHub Copilot Workspace for pull requests'
prodname_copilot_workspace_pr_short: 'Copilot Workspace for PRs'
prodname_copilot_workspace: 'Copilot Workspace'
prodname_copilot_workspace_short: 'Workspace'
# Windows
prodname_windows_terminal: 'Windows Terminal'
# Command Palette
prodname_command_palette: 'GitHub Command Palette'
# Server Statistics
prodname_server_statistics: 'Server Statistics'
# GitHub Importer
prodname_importer: 'GitHub Importer'
# GitHub Actions Importer
prodname_actions_importer: 'GitHub Actions Importer'
# Node Eligibility Service
prodname_nes: Node Eligibility Service
# Links
product_url: >-
{% ifversion fpt or ghec %}github.com{% else %}HOSTNAME{% endif %}
pricing_url: 'https://github.com/pricing'
pricing_link: '[GitHub Pricing](https://github.com/pricing)'
raw_github_com: >-
{% ifversion fpt or ghec %}raw.githubusercontent.com{% else %}HOSTNAME/user/repo/raw{% endif %}
# GitHub Enterprise Server past versions
current-340-version: '11.10.354'
# Developer site product variables
rest_url: >-
{% ifversion fpt or ghec %}https://api.github.com{% elsif ghes %}http(s)://HOSTNAME/api/v3{% endif %}
# Use this inside command-line code blocks
# Enterprise OAuth paths that don't include "/graphql" or "/api/v3"
oauth_host_code: >-
{% ifversion fpt or ghec %}https://github.com{% else %}http(s)://HOSTNAME{% endif %}
device_authorization_url: >-
{%- ifversion fpt or ghec %}
[`https://github.com/login/device`](https://github.com/login/device)
{%- elsif ghes %}
`http(s)://HOSTNAME/login/device`
{%- endif %}
graphql_url: >-
{% ifversion fpt or ghec %}https://api.github.com/graphql{% elsif ghes %}http(s)://HOSTNAME/api/graphql{% endif %}