rename Guides featured links to Start here (github#34425)

rsese · web-flow · commit 9c57e8a298f5 · 2023-02-06T18:14:35.000Z
diff --git a/components/context/ProductLandingContext.tsx b/components/context/ProductLandingContext.tsx
@@ -45,7 +45,8 @@ export type ProductLandingContextT = {
   productUserExamples: Array<{ username: string; description: string }>
   productCommunityExamples: Array<{ repo: string; description: string }>
   featuredArticles: Array<{
-    label: string // Guides
+    key: string // Featured article section key (startHere, popular, etc.)
+    label: string // Start here, Popular, etc.
     viewAllHref?: string // If provided, adds a "View All ->" to the header
     viewAllTitleText?: string // Adds 'title' attribute text for the "View All" href
     articles: Array<FeaturedLink>
@@ -133,16 +134,17 @@ export const getProductLandingContextFromRequest = async (
 
     featuredArticles: Object.entries(req.context.featuredLinks || [])
       .filter(([key]) => {
-        return key === 'guides' || key === 'popular' || key === 'videos'
+        return key === 'startHere' || key === 'popular' || key === 'videos'
       })
       .map(([key, links]: any) => {
         return {
+          key,
           label:
             key === 'popular' || key === 'videos'
               ? req.context.page.featuredLinks[key + 'Heading'] || req.context.site.data.ui.toc[key]
               : req.context.site.data.ui.toc[key],
           viewAllHref:
-            key === 'guides' && !req.context.currentCategory && hasGuidesPage
+            key === 'startHere' && !req.context.currentCategory && hasGuidesPage
               ? `${req.context.currentPath}/guides`
               : '',
           articles: links.map((link: any) => {
diff --git a/components/landing/FeaturedArticles.tsx b/components/landing/FeaturedArticles.tsx
@@ -12,6 +12,8 @@ export const FeaturedArticles = () => {
   return (
     <div className="d-lg-flex gutter my-6 py-6">
       {featuredArticles.map((section, i) => {
+        const viewAllTitleText =
+          section.key === 'startHere' ? `All '${section.label}' content` : `All ${section.label}`
         return (
           <div
             key={section.label + i}
@@ -20,7 +22,7 @@ export const FeaturedArticles = () => {
             <ArticleList
               title={section.label}
               viewAllHref={section.viewAllHref}
-              {...(section.viewAllHref ? { viewAllTitleText: `All ${section.label}` } : {})}
+              {...(section.viewAllHref ? { viewAllTitleText } : {})}
               articles={section.articles}
             />
           </div>
diff --git a/content/README.md b/content/README.md
@@ -180,7 +180,7 @@ Example:
 featuredLinks:
   gettingStarted:
     - /path/to/page
-  guides:
+  startHere:
     - /guides/example
   popular:
     - /path/to/popular/article1
diff --git a/content/account-and-profile/index.md b/content/account-and-profile/index.md
@@ -5,7 +5,7 @@ intro: 'Make {% data variables.product.product_name %} work best for you by adju
 introLinks:
   quickstart: /get-started/onboarding/getting-started-with-your-github-account
 featuredLinks:
-  guides:
+  startHere:
     - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/changing-your-github-username
     - '{% ifversion ghae %}/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/about-your-personal-dashboard{% endif %}'
     - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme
diff --git a/content/actions/index.md b/content/actions/index.md
@@ -6,7 +6,7 @@ introLinks:
   overview: /actions/learn-github-actions/understanding-github-actions
   quickstart: /actions/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - /actions/learn-github-actions
     - /actions/examples
     - /actions/automating-builds-and-tests/about-continuous-integration
diff --git a/content/admin/index.md b/content/admin/index.md
@@ -69,7 +69,7 @@ introLinks:
 changelog:
   label: enterprise
 featuredLinks:
-  guides:
+  startHere:
     - '{% ifversion ghae %}/admin/user-management/managing-users-in-your-enterprise/auditing-users-across-your-enterprise{% endif %}'
     - /admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise
     - /admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies
diff --git a/content/authentication/index.md b/content/authentication/index.md
@@ -21,7 +21,7 @@ versions:
 introLinks:
   overview: /authentication/keeping-your-account-and-data-secure/about-authentication-to-github
 featuredLinks:
-  guides:
+  startHere:
     - /authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent
     - /authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
     - /authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication
diff --git a/content/billing/index.md b/content/billing/index.md
@@ -8,7 +8,7 @@ redirect_from:
 introLinks:
   overview: '{% ifversion fpt or ghec %}/billing/managing-your-github-billing-settings/about-billing-on-github{% elsif ghes%}/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise{% endif %}'
 featuredLinks:
-  guides:
+  startHere:
     - '{% ifversion fpt or ghec %}/billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method{% endif %}'
     - '{% ifversion fpt %}/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription{% endif %}'
     - '{% ifversion ghec %}/billing/managing-billing-for-your-github-account/about-billing-for-your-enterprise{% endif %}'
diff --git a/content/code-security/index.md b/content/code-security/index.md
@@ -5,7 +5,7 @@ intro: 'Build security into your {% data variables.product.prodname_dotcom %} wo
 introLinks:
   overview: /code-security/getting-started/github-security-features
 featuredLinks:
-  guides:
+  startHere:
     - /code-security/getting-started/securing-your-repository
     - /code-security/getting-started/securing-your-organization
     - '{% ifversion fpt or ghec %}/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory{% endif %}'
diff --git a/content/codespaces/index.md b/content/codespaces/index.md
@@ -6,7 +6,7 @@ introLinks:
   overview: /codespaces/overview
   quickstart: /codespaces/getting-started/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - /codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization
     - /codespaces/getting-started/the-codespace-lifecycle
     - /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers
diff --git a/content/communities/index.md b/content/communities/index.md
@@ -8,7 +8,7 @@ redirect_from:
 changelog:
   label: wikis
 featuredLinks:
-  guides:
+  startHere:
     - /communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors
     - /communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project
     - /communities/moderating-comments-and-conversations/managing-disruptive-comments
diff --git a/content/copilot/index.md b/content/copilot/index.md
@@ -10,7 +10,7 @@ introLinks:
   overview: /copilot/overview-of-github-copilot/about-github-copilot
   quickstart: /copilot/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - /copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code
     - /copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide
     - /copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio
diff --git a/content/desktop/index.md b/content/desktop/index.md
@@ -5,7 +5,7 @@ intro: 'With GitHub Desktop, you can interact with GitHub using a GUI instead of
 introLinks:
   overview: /desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop
 featuredLinks:
-  guides:
+  startHere:
     - /desktop/installing-and-configuring-github-desktop/overview/creating-your-first-repository-using-github-desktop
     - /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop
     - /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github
diff --git a/content/developers/index.md b/content/developers/index.md
@@ -5,7 +5,7 @@ introLinks:
   About apps: /developers/apps/getting-started-with-apps/about-apps
 layout: product-landing
 featuredLinks:
-  guides:
+  startHere:
     - /developers/apps/getting-started-with-apps/differences-between-github-apps-and-oauth-apps
     - /developers/apps/building-github-apps/creating-a-github-app
     - /developers/apps/building-github-apps/authenticating-with-github-apps
diff --git a/content/discussions/index.md b/content/discussions/index.md
@@ -5,7 +5,7 @@ intro: '{% data variables.product.prodname_discussions %} is a collaborative com
 introLinks:
   quickstart: /discussions/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - /discussions/collaborating-with-your-community-using-discussions/about-discussions
     - /discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion
     - /discussions/managing-discussions-for-your-community/moderating-discussions
diff --git a/content/education/index.md b/content/education/index.md
@@ -5,7 +5,7 @@ intro: '{% data variables.product.prodname_education %} helps you teach or learn
 introLinks:
   quickstart: /education/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/apply-to-github-global-campus-as-a-student
     - /education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher
     - /education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution
diff --git a/content/get-started/index.md b/content/get-started/index.md
@@ -25,7 +25,7 @@ layout: product-landing
 introLinks:
   quickstart: /get-started/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - /get-started/learning-about-github/githubs-products
     - /get-started/onboarding/getting-started-with-your-github-account
     - /get-started/onboarding/getting-started-with-github-team
diff --git a/content/github-cli/index.md b/content/github-cli/index.md
@@ -14,7 +14,7 @@ introLinks:
   quickstart: /github-cli/github-cli/quickstart
   reference: /github-cli/github-cli/github-cli-reference
 featuredLinks:
-  guides:
+  startHere:
     - /github-cli/github-cli/creating-github-cli-extensions
     - /github-cli/github-cli/using-github-cli-extensions
     - /actions/using-workflows/using-github-cli-in-workflows
diff --git a/content/graphql/index.md b/content/graphql/index.md
@@ -5,7 +5,7 @@ shortTitle: GraphQL API
 introLinks:
   overview: /graphql/overview/about-the-graphql-api
 featuredLinks:
-  guides:
+  startHere:
     - /graphql/guides/forming-calls-with-graphql
     - /graphql/guides/introduction-to-graphql
     - /graphql/guides/using-the-explorer
diff --git a/content/issues/index.md b/content/issues/index.md
@@ -6,7 +6,7 @@ introLinks:
   overview: /issues/tracking-your-work-with-issues/about-issues
   quickstart: /issues/tracking-your-work-with-issues/quickstart
 featuredLinks:
-  guides:
+  startHere:
     - /issues/tracking-your-work-with-issues/creating-an-issue
     - /issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects
     - /issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects
diff --git a/content/organizations/index.md b/content/organizations/index.md
@@ -9,7 +9,7 @@ redirect_from:
 introLinks:
   overview: /organizations/collaborating-with-groups-in-organizations/about-organizations
 featuredLinks:
-  guides:
+  startHere:
     - /get-started/learning-about-github/types-of-github-accounts
     - /organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization
     - /organizations/organizing-members-into-teams/about-teams
diff --git a/content/packages/index.md b/content/packages/index.md
@@ -6,7 +6,7 @@ introLinks:
   quickstart: /packages/quickstart
   reference: /packages/manage-packages
 featuredLinks:
-  guides:
+  startHere:
     - /packages/learn-github-packages
     - /packages/managing-github-packages-using-github-actions-workflows
     - /packages/learn-github-packages/installing-a-package
diff --git a/content/pages/index.md b/content/pages/index.md
@@ -6,7 +6,7 @@ introLinks:
   quickstart: /pages/quickstart
   overview: /pages/getting-started-with-github-pages/about-github-pages
 featuredLinks:
-  guides:
+  startHere:
     - /pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site
     - /pages/getting-started-with-github-pages/creating-a-github-pages-site
     - '{% ifversion fpt or ghec %}/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site{% endif %}'
diff --git a/content/pull-requests/index.md b/content/pull-requests/index.md
@@ -4,7 +4,7 @@ intro: 'Learn how to use pull requests to suggest changes to a project, receive
 introLinks:
   overview: /pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests
 featuredLinks:
-  guides:
+  startHere:
     - /pull-requests/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message
     - /pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line
     - /pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository
diff --git a/content/repositories/index.md b/content/repositories/index.md
@@ -5,7 +5,7 @@ introLinks:
   quickstart: /get-started/quickstart/create-a-repo
   overview: /repositories/creating-and-managing-repositories/about-repositories
 featuredLinks:
-  guides:
+  startHere:
     - /repositories/creating-and-managing-repositories/cloning-a-repository
     - /repositories/creating-and-managing-repositories/restoring-a-deleted-repository
     - /repositories/working-with-files/managing-files/adding-a-file-to-a-repository
diff --git a/content/rest/index.md b/content/rest/index.md
@@ -6,7 +6,7 @@ introLinks:
   quickstart: /rest/quickstart
   overview: /rest/guides/getting-started-with-the-rest-api
 featuredLinks:
-  guides:
+  startHere:
     - /rest/guides/getting-started-with-the-rest-api
     - /rest/guides/basics-of-authentication
     - /rest/guides/best-practices-for-integrators
diff --git a/content/search-github/index.md b/content/search-github/index.md
@@ -4,7 +4,7 @@ intro: 'Learn how to use the search functions available on GitHub to find differ
 introLinks:
   overview: /search-github/getting-started-with-searching-on-github/about-searching-on-github
 featuredLinks:
-  guides:
+  startHere:
     - /search-github/searching-on-github/searching-issues-and-pull-requests
     - /search-github/searching-on-github/searching-code
     - /search-github/searching-on-github/searching-for-repositories
diff --git a/content/sponsors/index.md b/content/sponsors/index.md
@@ -11,7 +11,7 @@ changelog:
   label: sponsors
 examples_source: data/product-examples/sponsors/user-examples.yml
 featuredLinks:
-  guides:
+  startHere:
     - /sponsors/sponsoring-open-source-contributors/managing-your-sponsorship
     - /sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization
     - /sponsors/receiving-sponsorships-through-github-sponsors/managing-your-payouts-from-github-sponsors
diff --git a/content/support/index.md b/content/support/index.md
@@ -22,7 +22,7 @@ topics:
 introLinks:
   overview: /support/learning-about-github-support/about-github-support
 featuredLinks:
-  guides:
+  startHere:
     - /support/contacting-github-support/creating-a-support-ticket
     - /support/contacting-github-support/viewing-and-updating-support-tickets
     - '{% ifversion ghes or ghec %}/support/learning-about-github-support/about-ticket-priority{% endif %}'
diff --git a/data/ui.yml b/data/ui.yml
@@ -46,7 +46,7 @@ homepage:
 toc:
   getting_started: Getting started
   popular: Popular
-  guides: Guides
+  startHere: Start here
   whats_new: What's new
   videos: Videos
   all_changelogs: All changelog posts
diff --git a/lib/frontmatter.js b/lib/frontmatter.js
@@ -97,7 +97,7 @@ export const schema = {
           type: 'array',
           items: { type: 'string' },
         },
-        guides: {
+        startHere: {
           type: 'array',
           items: { type: 'string' },
         },
