Copy improvements (#943)

* Change nav title

* Add subsection content and reogranize

* Rewrite

* Change word

* Language changes

---------

Co-authored-by: Chase Fleming <[email protected]>

docusaurus.config.js

@@ -255,7 +255,7 @@ const config = {
           {
             to: 'build/flow',
             position: 'left',
-            label: 'Build',
+            label: 'Build With Cadence',
             activeBasePath: '/build',
           },
           {

src/ui/design-system/src/lib/Components/ContentFeatureList/index.tsx

@@ -6,35 +6,35 @@ const ContentFeatures: Record<string, ContentFeatureProps> = {
     icon: 'feature-why-flow-icon',
     image: 'feature-why-flow-image',
     header: 'Why Flow',
-    text: 'Introduction to the Network',
+    text: 'Explore Flow\'s scalable and high-performance blockchain architecture',
     link: '/build/flow',
   },
   'smart-accounts': {
     icon: 'feature-wand-icon',
     image: 'feature-wand-image',
     header: 'Smart Accounts',
-    text: 'Enhance UX with a flexible Account structure and key management',
+    text: 'Benefit from flexible accounts with seamless key management for security and convenience',
     link: 'build/basics/accounts',
   },
   transactions: {
     icon: 'feature-stacks-icon',
     image: 'feature-stacks-image',
     header: 'Bundle & Scripted Transactions',
-    text: 'Introduction to gasless, scripted and bundled transactions',
+    text: 'Streamline operations using gasless, scripted, and bundled transactions',
     link: '/build/basics/transactions',
   },
   'code-scripts': {
     icon: 'feature-code-scripts-icon',
     image: 'feature-code-scripts-image',
     header: 'Scripted Queries',
-    text: 'Introduction to Queries',
+    text: 'Access and interact with on-chain data efficiently using powerful scripting',
     link: '/build/basics/scripts',
   },
   evm: {
     icon: 'feature-evm-icon',
     image: 'feature-evm-image',
     header: 'EVM Equivalency',
-    text: 'Coming in from EVM? Discover key similarities and differences to launch faster',
+    text: 'Use Solidity contracts on Flow without code changes',
     link: '/evm/about',
   },
 };
@@ -44,8 +44,7 @@ export function ContentFeatureList(): React.ReactElement {
     <div className="container">
       <div className="flex flex-col md:w-1/2 md:block pb-9">
         <div className="text-h2 pb-5">Key Features</div>
-        Discover the unique features of Flow, unlocking innovative possibilities
-        for your decentralized applications and smart contracts.
+        Discover the innovative features that make Flow the blockchain built for the next generation of apps, games, and digital assets. Learn about its scalable architecture, developer-friendly environment, and resource-oriented programming with Cadence.
       </div>
       <div className={`grid grid-cols-1 md:grid-cols-2 lg:grid-cols-6 gap-4`}>
         <div className="lg:col-span-2">

src/ui/design-system/src/lib/Components/HomepageStartList/index.tsx

@@ -56,6 +56,10 @@ const homepagePillData: Record<string, HomepagePillItemsProps> = {
 export function HomepageStartList(): React.ReactElement {
   return (
     <div className="container mx-auto p-4">
+      <div className="flex flex-col md:w-1/2 md:block pb-9">
+        <div className="text-h2 pb-5">EVM on Flow</div>
+        Unlock the ability to run EVM-compatible smart contracts on Flow. Leverage your existing Solidity skills and EVM tools to build on Flow's high-performance blockchain, combining familiar development experiences with Flow's scalability and efficiency.
+      </div>
       <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
         <div className="col-span-1 md:col-span-1 md:row-span-2 lg:col-span-1 lg:row-span-2 rounded-lg shadow p-2">
           <HomepageStartItem key={0} {...homepageData['cadence-course']} />

src/ui/design-system/src/lib/Components/HomepageStartListCadence/index.tsx

@@ -56,6 +56,10 @@ const homepagePillData: Record<string, HomepagePillItemsProps> = {
 export function HomepageStartListCadence(): React.ReactElement {
   return (
     <div className="container mx-auto p-4">
+      <div className="flex flex-col md:w-1/2 md:block pb-9">
+        <div className="text-h2 pb-5">Learn Cadence</div>
+        Dive into Cadence, Flow's powerful and secure smart contract language. Access comprehensive tutorials and documentation to start building sophisticated decentralized applications with ease and confidence.
+      </div>
       <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
         <div className="col-span-1 md:col-span-1 md:row-span-2 lg:col-span-1 lg:row-span-2 rounded-lg shadow p-2">
           <HomepageStartItemCadence

src/ui/design-system/src/lib/Components/LandingHeaderHome/index.tsx

@@ -35,7 +35,7 @@ export function LandingHeaderHome({
             href={'/build/flow'}
             className={'hover:no-underline hover:opacity-80'}
           >
-            Read Docs
+            Get Building
           </ButtonLink>
         </div>
       </div>

src/ui/design-system/src/lib/Pages/HomePage/index.tsx

@@ -27,10 +27,7 @@ export type HomePageProps = SocialLinksSignupProps & {
 
 const Description = (): JSX.Element => (
   <>
-    Dive into a rich collection of resources, tutorials, autonomous realms and
-    vibrant communities that unlock the full potential of Web3. Whether a
-    tinkerer or a seasoned developer, find everything you need to start and
-    elevate your projects.
+    Flow is a fast, decentralized platform for apps, games, and digital assets. Build and grow your projects on a scalable, secure network. Whether you're learning Cadence or using EVM compatibility, Flow empowers your innovative ideas.
   </>
 );
 
@@ -42,16 +39,16 @@ const HomePage = ({ discordUrl, githubUrl }: HomePageProps): JSX.Element => {
         discordUrl={discordUrl}
         githubUrl={githubUrl}
         tag="onflow"
-        title="Build with Flow"
+        title="Build On Flow"
       />
-      <HomepageStartList />
+      <ContentFeatureList />
 
       <PageSections>
         <TransitionPageSection sectionId="explore-more-content">
-          <ContentFeatureList />
+          <HomepageStartListCadence />
         </TransitionPageSection>
         <TransitionPageSection sectionId="start-list-cadence">
-          <HomepageStartListCadence />
+          <HomepageStartList />
         </TransitionPageSection>
         <TransitionPageSection
           className={'md:mx-4'}