* new article scaffolding * Add scaffolding * Migrate content for overview article * Add placeholder notes and migrate over some more content * First draft of updates to existing docs * Add H2 headers to the article * Draft of phase 0 content * Update phase 0 with more drafting * Fix subheaders and table formatting * Add unedited and slightly tweaked source material * Current draft of reworked content * Refactor everything * Add best practices and some partnership details * Touch-ups * Touch up intro and create a phased approaches reusable * Fix the intro * Move reusable * Add image for GHES versions * Fix links * Add HTML note around links that need to be versioned for GHEC once the GHEC version releases * Fix reusable * Tidy up session * Versioning around the links * migrate this content to another PR for easier reviewing * Add HTML note about versioning for GHEC * Revamp intro * Add product variables * Less is more in the intro * Fix the beginning * Copy-edits for first half * Add Markdown-friendly bullet points * unclear shift direction * Distinguish the rollout team roles * More active language & cut the note * Maybe too wordy * Edit facts section * Update the article path to fix tests * Add product variables for professional services * Another revision * More tidying * Fix spacing * Apply suggestions from code review Co-authored-by: Felicity Chapman <felicitymay@github.com> * Apply suggestions from code review Co-authored-by: Felicity Chapman <felicitymay@github.com> * Apply @felicitymay's input * Apply suggestions from code review Co-authored-by: Rachael Sewell <rachmari@github.com> * Fix link test by adding HTML note around GHEC only article for now * Apply @felicitymay's stellar input 🌠 Co-authored-by: Felicity Chapman <felicitymay@github.com> * Apply suggestions from code review * Apply suggestions from code review * GitHub Advanced Security "Deploying" guide (#22114) * Add draft content * Add gated features reusable * Revise draft * Revamp steps of phase 0 * Replace goals section with intro text * More revising * Standardize headers with sentence case & remove overview subheader * Phase 0 streamlined * Fix intro and GHAS Guidebook reference * Fix reusable * Phase 1 💖 * Phase 2 tightened * Standardize on subheaders * Update phase 3 * Add product variable * Fix some links to fix the tests * Apply @felicitymay's stellar input 🌠 Co-authored-by: Felicity Chapman <felicitymay@github.com> * Apply Felicity's input * Use more GHAS to ease the reading load * Update resusable * Replacing "organization" * Add dependency review verisoning Co-authored-by: “jmarlena” <“jmarlena@github.com”> Co-authored-by: Felicity Chapman <felicitymay@github.com> * Remove draft notes for appendix links * Fix subheader * Deploying before enabling GHAS * Replace organization * Fix variables * Add GHEC & GHES versioning * not sure why this space is a commit * Apply suggestions from code review Co-authored-by: Felicity Chapman <felicitymay@github.com> * Remove ghec versioning we don't need * Add repo reference * Remove versioning note ftw * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * Markdown, I love you Co-authored-by: Megan Christudas <meganchristudas@Megans-MBP.fios-router.home> Co-authored-by: jmarlena <jmarlena@github.com> Co-authored-by: “jmarlena” <“jmarlena@github.com”> Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com> Co-authored-by: Felicity Chapman <felicitymay@github.com> Co-authored-by: Rachael Sewell <rachmari@github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
226 lines
9.3 KiB
YAML
226 lines
9.3 KiB
YAML
# 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
|
|
|
|
company_short: 'GitHub'
|
|
|
|
# GitHub's flagship products
|
|
product_name: >-
|
|
{% ifversion ghec %}GitHub Enterprise Cloud{% elsif ghes %}GitHub Enterprise Server{% elsif ghae %}GitHub AE{% else %}GitHub{% endif %}
|
|
## Use this variable when the output should always be GitHub, regardless of the product the user is using
|
|
prodname_dotcom: 'GitHub'
|
|
|
|
## 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)
|
|
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_managed: 'GitHub AE'
|
|
prodname_ghe_one: 'GitHub One'
|
|
|
|
## Use these variables when referring specifically to a location within a product
|
|
product_location: >-
|
|
{% ifversion ghes %}your GitHub Enterprise Server instance{% elsif ghae %}your enterprise{% else %}GitHub.com{% endif %}
|
|
|
|
# Used ONLY when you need to refer to a GHES instance in an article that is versioned for non-GHES versions.
|
|
# Do not use in other situations!
|
|
product_location_enterprise: 'your GitHub Enterprise Server instance'
|
|
|
|
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)
|
|
## Phrase content so that the uncapitalized unified contributions or unified search variables are not used at the start of a sentence.
|
|
prodname_github_connect: 'GitHub Connect'
|
|
prodname_unified_contributions: 'unified contributions'
|
|
prodname_unified_search: 'unified search'
|
|
|
|
# GitHub Education
|
|
prodname_education: 'GitHub Education'
|
|
prodname_education_community: 'Education Community'
|
|
prodname_education_community_with_url: 'the [GitHub Education Community](https://education.github.community)'
|
|
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'
|
|
|
|
# GitHub CLI
|
|
prodname_cli: 'GitHub CLI'
|
|
|
|
# GitHub Desktop
|
|
prodname_desktop: 'GitHub Desktop'
|
|
desktop_link: 'https://desktop.github.com/'
|
|
|
|
# GitHub for Mobile
|
|
prodname_mobile: 'GitHub for mobile'
|
|
prodname_ios: 'GitHub for iOS'
|
|
prodname_android: 'GitHub for Android'
|
|
|
|
# GitHub Pages
|
|
prodname_pages: 'GitHub Pages'
|
|
|
|
# CodeQL
|
|
prodname_codeql: 'CodeQL'
|
|
prodname_ql: 'QL'
|
|
prodname_codeql_cli: 'CodeQL CLI'
|
|
|
|
# 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'
|
|
|
|
# API and developer docs
|
|
prodname_enterprise_api: 'the {% ifversion ghes %}GitHub Enterprise Server{% elsif ghae %}GitHub AE{% endif %} APIs'
|
|
prodname_support_forum_with_url: '[GitHub API Development and Support Forum](https://github.community/c/github-api-development-and-support/37)'
|
|
prodname_unfurls: 'Content Attachments'
|
|
|
|
# Azure AD
|
|
ae_azure_ad_app_link: 'the [GitHub AE application](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/aad.githubenterpriseserver)'
|
|
|
|
# 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'
|
|
|
|
# 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_emus: 'Enterprise Managed Users'
|
|
prodname_managed_user: 'managed user'
|
|
prodname_managed_users: 'managed users'
|
|
prodname_managed_users_caps: 'Managed users'
|
|
prodname_emu_enterprise: 'enterprise with managed users'
|
|
prodname_emu_org: 'organization with managed users'
|
|
|
|
# GitHub Issues
|
|
prodname_github_issues: 'GitHub Issues'
|
|
|
|
# GitHub Packages
|
|
prodname_registry: 'GitHub Packages'
|
|
prodname_container_registry: 'Container 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'
|
|
|
|
# Security Center
|
|
prodname_security_center: 'Security Center'
|
|
|
|
# Codespaces
|
|
prodname_codespaces: 'Codespaces'
|
|
prodname_github_codespaces: 'GitHub Codespaces'
|
|
prodname_serverless: 'web-based editor'
|
|
|
|
# GitHub resources: blog, jobs, Learning Lab
|
|
prodname_gcf: 'GitHub Community Support'
|
|
prodname_blog: 'the GitHub Blog'
|
|
prodname_jobs: 'GitHub Jobs'
|
|
prodname_learning: 'GitHub Learning Lab'
|
|
prodname_learning_link: 'https://lab.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: 'Professional Services'
|
|
|
|
# Security features / code scanning platform / Security Lab
|
|
prodname_security: 'GitHub Security Lab'
|
|
prodname_security_link: 'https://securitylab.github.com/'
|
|
prodname_security_advisories: 'GitHub Security Advisories'
|
|
|
|
# Security features and code scanning platform
|
|
prodname_secret_scanning: 'secret scanning'
|
|
prodname_secret_scanning_caps: 'Secret scanning'
|
|
prodname_code_scanning: 'code scanning'
|
|
prodname_code_scanning_capc: 'Code scanning'
|
|
prodname_codeql_runner: 'CodeQL runner'
|
|
prodname_advisory_database: 'GitHub Advisory Database'
|
|
prodname_codeql_workflow: 'CodeQL analysis workflow'
|
|
|
|
# Visual Studio
|
|
prodname_vs: 'Visual Studio'
|
|
prodname_vscode: 'Visual Studio Code'
|
|
prodname_vss_ghe: 'Visual Studio subscription with GitHub Enterprise'
|
|
prodname_vss_admin_portal_with_url: 'the [administrator portal for Visual Studio subscriptions](https://visualstudio.microsoft.com/subscriptions-administration/)'
|
|
|
|
# GitHub Dependabot
|
|
prodname_dependabot: 'Dependabot'
|
|
prodname_dependabot_alerts: 'Dependabot alerts'
|
|
prodname_dependabot_security_updates: 'Dependabot security updates'
|
|
prodname_dependabot_version_updates: 'Dependabot version updates'
|
|
|
|
# GitHub Archive Program
|
|
prodname_archive: 'GitHub Archive Program'
|
|
prodname_arctic_vault: 'Arctic Code Vault'
|
|
|
|
# GitHub Copilot
|
|
prodname_copilot: 'GitHub Copilot'
|
|
|
|
# Links
|
|
product_url: >-
|
|
{% ifversion fpt or ghec %}github.com{% else %}[hostname]{% endif %}
|
|
pricing_url: 'https://github.com/pricing'
|
|
signin_link: >-
|
|
{% ifversion fpt or ghec %}[Sign in](https://github.com/login){% else %}Sign in (`https://[hostname]/login`){% endif %}
|
|
signout_link: >-
|
|
{% ifversion fpt or ghec %}[Sign out](https://github.com/logout){% else %}Sign out (`https://[hostname]/logout`){% endif %}
|
|
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
|
|
# Use this inside command-line and other code blocks
|
|
doc_url_pre: >-
|
|
{% ifversion fpt or ghec %}https://docs.github.com/rest{% elsif ghes %}https://docs.github.com/enterprise/{{ currentVersion | version_num }}/rest{% elsif ghae %}https://docs.github.com/github-ae@latest/rest{% endif %}
|
|
# Use this inside command-line code blocks
|
|
api_url_pre: >-
|
|
{% ifversion fpt or ghec %}https://api.github.com{% elsif ghes %}http(s)://<em>[hostname]</em>/api/v3{% elsif ghae %}https://<em>[hostname]</em>/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: >-
|
|
[`https://github.com/login/device`](https://github.com/login/device)
|
|
# Use this all other code blocks
|
|
api_url_code: >-
|
|
{% ifversion fpt or ghec %}https://api.github.com{% elsif ghes %}http(s)://[hostname]/api/v3{% elsif ghae %}https://[hostname]/api/v3{% endif %}
|
|
# Use this inside command-line code blocks
|
|
graphql_url_pre: >-
|
|
{% ifversion fpt or ghec %}https://api.github.com/graphql{% elsif ghes %}http(s)://<em>[hostname]</em>/api/graphql{% elsif ghae %}https://api.<em>[hostname]</em>/graphql{% endif %}
|
|
# Use this all other code blocks
|
|
graphql_url_code: >-
|
|
{% ifversion fpt or ghec %}https://api.github.com/graphql{% elsif ghes %}http(s)://[hostname]/api/graphql{% elsif ghae %}https://api.[hostname]/graphql{% endif %}
|