Merge pull request #505 from trilitech/Nic-home-page

refactor home page

docs/architecture/bakers.md

@@ -46,7 +46,7 @@ The delegate must have a baking power of at least 6,000 tez to be allowed to bak
 A delegate also participates in [governance](/architecture/governance) in proportion to their _voting power_.
 The voting power of a delegate is computed in a similar way to the baking power except that no distinction is made between tez that are staked or not staked.
 
-Bakers must run at least one Tezos node and a baker service to go with it.
+Bakers must run at least one Tezos node and a baker service to go with it, see our [tutorial for bakers](/tutorials/join-dal-baker).
 These services must run at all times with a stable power source and internet connection, because periods of inactivity for a baker entail losses of rewards, and eventually being marked as inactive and temporarily excluded from baking.
 
 ## Delegating to a baker
@@ -93,6 +93,8 @@ Slashing exposure | Yes | No
 
 To start delegating and staking, use the app at https://stake.tezos.com.
 
+To start baking, use our [tutorial for bakers](/tutorials/join-dal-baker).
+
 For more information about the different options to participate to the Tezos network (baking, staking, or delegating), see [Running Octez](https://tezos.gitlab.io/introduction/howtorun.html) in the Octez documentation.
 
 For full details about baking, see [Node and Baking](https://opentezos.com/node-baking/baking/introduction/) on opentezos.com.

docs/overview/index.md

@@ -18,6 +18,7 @@ Several sites provide information about different parts of the Tezos ecosystem.
 This site includes:
 
 - [Tutorials](/tutorials) that can help you start using Tezos
+- A brief introduction to Tezos for end users (non-technical users)
 - A presentation of the main Tezos concepts and features for technical users, including developers and bakers
 
 For more details on installing, using, or contributing to the platform, see the Octez documentation at https://tezos.gitlab.io/index.html.

docusaurus.config.js

@@ -26,8 +26,8 @@ frame-src https://tezosbot.vercel.app;`;
 /** @type {import('@docusaurus/types').Config} */
 module.exports = async function createConfigAsync() {
   return {
-    title: 'Tezos Developer Documentation',
-    tagline: 'Get started developing on Tezos by learning about its features, going through application development tutorials, and exploring the tools that are available to Tezos developers.',
+    title: 'Tezos Documentation',
+    tagline: 'Get started using Tezos or developing on Tezos, by learning about its features, following tutorials and exploring the development tools.',
     favicon: 'img/favicon.ico',
     url: 'https://docs.tezos.com',
     baseUrl: '/',

src/components/HomepageFeatures/index.js

@@ -3,38 +3,49 @@ import clsx from 'clsx';
 import styles from './styles.module.css';
 
 const FeatureList = [
+  {
+    emoji: '🧑‍💻️',
+    title: 'Tezos for end users',
+    href: 'using',
+    description: (
+      <>
+        Learn how to set up a Tezos account and manage it with a wallet, stake tez, and use applications.
+      </>
+    ),
+    link: 'Start using Tezos'
+  },
   {
     emoji: '💡',
-    title: 'Tezos overview',
+    title: 'Tezos for developers',
     href: 'overview',
     description: (
       <>
-        Read about how Tezos works, what distinguishes it from other blockchains, what developers use it for, and how it hosts decentralized applications that run independently of any authority.
+        Read about how Tezos works, what distinguishes it from other blockchains, and how to develop decentralized applications.
       </>
     ),
-    link: 'Start learning'
+    link: 'Start building'
   },
   {
-    emoji: '📚',
-    title: 'Tutorials',
-    href: 'tutorials',
+    emoji: '🍞',
+    title: 'Tezos for bakers',
+    href: 'architecture/bakers',
     description: (
       <>
-        Work through tutorials that cover coding smart contracts and applications that use those smart contracts, from simple to complex, in multiple languages.
+        Read how to participate in Tezos and how to set up a full-fledged Octez node for baking.
       </>
     ),
-    link: 'View tutorials'
+    link: 'Start baking'
   },
   {
-    emoji: '🧑‍💻️',
-    title: 'Development environments',
-    href: 'developing',
+    emoji: '📚',
+    title: 'Tutorials',
+    href: 'tutorials',
     description: (
       <>
-        Set up a development environment for your language of choice and its related tools. Use a local environment with a sandbox or a web-based IDE for development work.
+        Work through tutorials from simple to complex, that cover using Tezos, baking, and coding smart contracts and applications in multiple languages.
       </>
     ),
-    link: 'Start developing'
+    link: 'View tutorials'
   },
 
 ];
@@ -147,4 +158,3 @@ export default function HomepageFeatures() {
     </section>
   );
 }
-

src/components/HomepageFeatures/styles.module.css

@@ -19,9 +19,9 @@
 }
 
 .feature {
-  flex: 0 0 calc(33.33% - 30px);
+  flex: 0 0 calc(25% - 30px);
   /* Adjust the width based on the number of cards */
-  max-width: calc(33.33% - 30px);
+  max-width: calc(25% - 30px);
   /* Adjust the width based on the number of cards */
   height: auto;
   padding: 30px;
@@ -197,4 +197,3 @@ button.featureButton.selected::before {
       height: 16vh !important;
   }
 }
-