Update landing page

src/components/DocsetMenu/DocsetMenu.js

@@ -29,7 +29,7 @@ import {ReactComponent as Router} from '../../assets/icons/router.svg';
 import {RxComponent1} from 'react-icons/rx';
 import {ReactComponent as Satellite} from '../../assets/icons/satellite.svg';
 import {ReactComponent as Schema} from '../../assets/icons/schema.svg';
-import {SiKotlin, SiReact, SiSwift} from 'react-icons/si';
+import {SiGraphql, SiKotlin, SiReact, SiSwift} from 'react-icons/si';
 import {SlChart} from 'react-icons/sl';
 import {TbRoute} from 'react-icons/tb';
 import {VscOrganization} from 'react-icons/vsc';
@@ -47,6 +47,7 @@ export const DOCSET_ICONS = {
   'apollo-kotlin': <SiKotlin />,
   'apollo-server': <CustomIcon icon={Satellite} />,
   federation: <CustomIcon icon={Federation} />,
+  graphql: <SiGraphql />,
   graphos: <CustomIcon icon={Schema} />,
   rover: <GoTerminal />,
   router: <CustomIcon icon={Router} />,

src/content/basics/index.mdx

@@ -1,13 +1,12 @@
 ---
-title: Apollo Docs
+title: Documentation
 toc: true
 subtitle: ' '
 description: Learn how Apollo GraphQL can help enterprise architects, API implementers, and client developers build, deploy, and manage a supergraph of unified microservices, data sources, and applications.
 ---
 
 import {ButtonGroup, VStack} from '@chakra-ui/react';
 import {
-  CTA_LEARN,
   CommunityButton,
   Docset,
   DocsetGrid,
@@ -22,92 +21,98 @@
   SiYoutube
 } from 'react-icons/si';
 
-**Apollo GraphOS** is the developer platform for building a [**supergraph**](./intro/platform/): a unified network of your organization's data and services, all composed into a single distributed **GraphQL API**.
-
-Apollo provides tools for every developer that interacts with GraphQL—whether you're [building your first API](#for-api-implementers), [querying an existing one](#for-client-developers), or [moving your entire organization onto the supergraph](#for-enterprise-architects).
-
-## For GraphQL newcomers
-
-<Odyssey />
-
-## For API implementers
+**Apollo GraphOS** is the developer platform for building a [**supergraph**](./intro/platform/)—a unified network of your organization's data and services, all composed into a single distributed **GraphQL API**.
 
 <DocsetGrid>
+  <Docset
+    icon={DOCSET_ICONS.graphql}
+    title="Benefits of GraphQL"
+    description="Understand how GraphQL and Apollo can help you improve your organization's developer experience and ship features faster."
+    path="/intro/benefits"
+    cta="Explore the benefits of GraphQL"
+  />
   <Docset
     icon={DOCSET_ICONS.graphos}
-    title="GraphOS"
-    description="Connect any GraphQL API to Apollo's cloud platform to enable powerful features like metrics reporting, schema validation, and the Explorer IDE."
+    title="Introducing GraphOS"
+    description="Connect any GraphQL API to Apollo's cloud platform to enable powerful features like schema governance and metrics reporting."
     path="/graphos"
-    cta={CTA_LEARN}
+    cta="Learn about GraphOS"
   />
 </DocsetGrid>
 
-<DocsetGrid>
-  <Docset
-    icon={DOCSET_ICONS['apollo-server']}
-    title="Apollo Server"
-    description="Build a production-ready GraphQL API in Node.js. Fetch and combine results from multiple data sources."
-    path="/apollo-server"
-  />
-  <Docset
-    icon={DOCSET_ICONS.rover}
-    title="Rover CLI"
-    description="Manage your GraphOS graphs and their schemas from the command line."
-    path="/rover"
-  />
-</DocsetGrid>
+Apollo provides tools and resources for every developer who interacts with GraphQL. That's whether you're just [starting with GraphQL](#for-graphql-newcomers), [moving your entire organization onto the supergraph](#for-enterprise-architects), [building your first API](#for-api-implementers), or [querying an existing one](#for-client-developers).
+
+## For GraphQL newcomers
+
+<Odyssey />
 
 ## For enterprise architects
 
 <DocsetGrid>
   <Docset
     icon={DOCSET_ICONS.federation}
-    title="Apollo Federation"
-    description="Implement a single, unified supergraph that combines multiple GraphQL APIs."
+    title="Combine APIs"
+    description="Implement a single, unified supergraph that combines multiple APIs with Apollo Federation."
     path="/federation"
-    cta={CTA_LEARN}
+    cta="Explore Apollo Federation docs"
   />
   <Docset
     icon={DOCSET_ICONS.router}
-    title="Apollo Router"
-    description="Deploy your supergraph's router in your own infrastructure and configure it to meet advanced enterprise requirements."
+    title="Host your router"
+    description="Deploy and configure your supergraph's router in your own infrastructure."
     path="/router"
+    cta="Explore the Apollo Router docs"
   />
   <Docset
     icon={DOCSET_ICONS.technotes}
-    title="Tech Notes"
-    description="Read in-depth articles on specialized Apollo topics."
+    title="Learn from the field"
+    description="Read in-depth articles on specialized Apollo topics from our own solutions architects."
     path="/technotes"
     cta="Browse tech notes"
   />
   <Docset
     icon={DOCSET_ICONS.principled}
-    title="Principled GraphQL"
-    description="Read about the fundamental principles that underlie Apollo's supergraph architecture."
+    title="Master principles"
+    description="Learn about the fundamental principles that underlie Apollo's supergraph architecture."
     path="https://principledgraphql.com/"
     cta="Visit Principled GraphQL"
   />
 </DocsetGrid>
 
+## For API implementers
+
+<DocsetGrid>
+  <Docset
+    icon={DOCSET_ICONS['apollo-server']}
+    title="Build a GraphQL API"
+    description="Build a production-ready API that handles multiple datasources in Node.js with Apollo Server."
+    path="/apollo-server"
+    cta="Explore Apollo Server docs"
+  />
+  <Docset
+    icon={DOCSET_ICONS.rover}
+    title="Manage via CLI"
+    description="Manage, configure, and publish your GraphOS graphs from the command line with the Rover CLI."
+    path="/rover"
+    cta="Explore Rover CLI docs"
+  />
+</DocsetGrid>
+
 ## For client developers
 
 **Apollo Client** is the industry-standard GraphQL client library. Execute GraphQL operations, cache their results, and manage your application's state in one place.
 
+<Docset icon={DOCSET_ICONS['apollo-client']} title="React / JS" path="/react" />
 <DocsetGrid>
-  <Docset
-    icon={DOCSET_ICONS['apollo-client']}
-    title="React / JS"
-    path="/react"
-  />
   <Docset icon={DOCSET_ICONS['apollo-ios']} title="iOS" path="/ios" />
   <Docset icon={DOCSET_ICONS['apollo-kotlin']} title="Kotlin" path="/kotlin" />
 </DocsetGrid>
 
-<VStack pt="4" spacing="4" textAlign="center" maxW="md" mx="auto">
-
 <h3> Join our community 💬 </h3>
 
-We love hearing from you! Here are a few ways you can connect with us and other Apollo community members.
+We love hearing from you! Here are a few ways to connect with us and other Apollo community members.
+
+<VStack pt="4" spacing="4" textAlign="center" maxW="md" mx="auto">
 
 <ButtonGroup variant="ghost">
   <CommunityButton

styles/Apollo/WordList.yml

@@ -44,7 +44,6 @@ swap:
   "HTTPs": HTTPS
   "homepage": homepage
   "in order to": to
-  "ios": iOS
   "javascript": JavaScript
   "k8s": Kubernetes
   "long press": touch & hold

styles/config/vocabularies/Docs/accept.txt

@@ -1,6 +1,5 @@
 [Aa]ction(?:ed|ing)?
 APIs?
-Apollo
 [Aa]pprovers?
 APQs?
 APM('s)?