Merge pull request #913 from vexr/improve-cli-gui-guidance

Improve CLI vs GUI farming method guidance

Author: EmilFattakhov

docs/farming-&-staking/farming/intro.mdx

@@ -32,6 +32,64 @@ import Badge from '@site/src/components/Badge';
 For those who prefer a visual guide, we have prepared installation videos to assist you. The videos will help you to set up the Space Acres <Badge variant="recommended" text="Recommended" /> farming application in under 10 minutes. Please follow [the installation videos](/farming/space-acres/install#installation-videos) to use SubWallet to create a compatible Substrate account and refer to the detailed guide on downloading and configuring Autonomys' farming application, Space Acres.
 :::
 
+## Choosing Your Farming Method
+
+Before reviewing system requirements, it's important to choose the right farming method for your needs. Autonomys offers two primary options for farming: Space Acres (GUI) and the CLI.
+
+### <Icon icon={ICONS.FARMER} />Space Acres <Badge variant="recommended" text="Recommended" />
+
+**Space Acres is a user-friendly, multi-platform GUI application that simplifies getting started with farming.** Available for Windows, macOS, and Linux, it offers the most common set of configuration options in an intuitive visual interface, making it perfect for beginners and most farming scenarios across all major operating systems.
+
+**Why choose Space Acres:**
+- **Multi-platform support**: Native applications for Windows, macOS, and Linux
+- **Beginner-friendly**: Visual setup wizard guides you through the entire process
+- **Simplified configuration**: Most common farming options available through easy-to-use interface
+- **Real-time monitoring**: Visual dashboard shows farming progress, sector status, and rewards
+- **Automatic updates**: Built-in update mechanism keeps your farming software current
+- **Error handling**: Clear error messages and troubleshooting guidance
+- **No command line knowledge required**: Everything managed through the graphical interface
+
+**Perfect for:**
+- First-time farmers getting started with the Autonomys Network
+- Users who prefer visual interfaces over command-line tools
+- Standard farming setups with typical configuration requirements
+- Anyone wanting a "set it and forget it" farming experience
+
+### <Icon icon={ICONS.CODE} />CLI
+
+**The CLI is designed for users seeking additional configuration options, advanced setups, or specialized farming scenarios.**
+
+**Why choose CLI:**
+- **Advanced configuration**: Access to all available farming parameters and fine-tuning options
+- **Multiple farms with single node**: Efficiently manage multiple farm locations from one node instance
+- **Farming clusters**: Support for large to massive farming operations with distributed architecture
+- **Automation & scripting**: Easy integration with automation tools and custom scripts
+- **Resource optimization**: Granular control over system resource allocation
+- **Headless operation**: Run on servers without graphical interfaces
+
+**Perfect for:**
+- Experienced users comfortable with command-line interfaces
+- Users needing specific configuration parameters not available in Space Acres
+- Farming clusters and enterprise deployments with distributed components (node, controller, cache, plotter, farmer) across multiple servers to optimize load distribution and accelerate plotting
+- Automation and integration with existing infrastructure
+- Headless server environments
+
+### Feature Comparison
+
+| Feature | Space Acres | CLI |
+|---------|-------------|------------|
+| **Ease of Use** | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Beginner-friendly | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Requires command-line knowledge |
+| **Setup Time** | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Quick visual setup | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Manual configuration |
+| **Configuration Options** | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Most common options | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> All available options |
+| **Multiple Farms** | Not supported | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Full multi-farm support |
+| **Scale Support** | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Small to medium farms | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> All scales including clusters |
+| **Monitoring** | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Visual dashboard | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Log-based monitoring |
+| **Resource Control** | Not configurable | <Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /><Icon icon={ICONS.STAR} /> Granular optimization |
+
+**Getting Started:**
+- **[Space Acres Installation Guide](/farming/space-acres/install)** - Step-by-step visual setup
+- **[CLI Installation Guide](/farming/cli/install)** - Command-line setup instructions
+
 ## Operating System
 
 | Application | <Icon icon={ICONS.UBUNTU} /> Ubuntu | <Icon icon={ICONS.WINDOWS} /> Windows | <Icon icon={ICONS.MACOS} /> macOS |

docs/farming-&-staking/farming/space-acres/install.mdx

@@ -29,6 +29,16 @@ import LinuxPage from './platforms/_linux.mdx';
 
 # <Badge variant="recommended" iconOnly /> Install Space Acres
 
+Space Acres is our recommended farming application because it **simplifies getting started** with the Autonomys Network. As a user-friendly GUI application, it provides the most common configuration options through an intuitive visual interface, making farming accessible to everyone—from complete beginners to experienced users who want a streamlined experience.
+
+**Why Space Acres is recommended:**
+- **Beginner-friendly setup**: Visual wizard guides you through the entire process
+- **All-in-one solution**: Node and farmer combined in a single application
+- **Real-time monitoring**: Visual dashboard shows your farming progress and rewards
+- **Simplified configuration**: Most common farming scenarios covered through easy-to-use interface
+
+**Need more advanced features?** If you require multiple farms, farming clusters, or specialized configuration options not available in the GUI, consider the [CLI](/farming/cli/install) instead.
+
 ## Before You Begin
 
 Make sure you have:

docs/index.mdx

@@ -151,8 +151,8 @@ You'll also notice the <Badge variant="testnet" text="Testnet" /> badge on certa
 Secure the network by storing archival history and earn rewards. Farmers maintain consensus, plot data to disk, and participate in the Distributed Storage Network (DSN).
 
 **Getting Started:**
-- **[Space Acres](/farming/space-acres/install)** <Badge variant="recommended" text="Recommended" /> - User-friendly GUI application perfect for beginners, with visual setup and monitoring
-- **[CLI Farmer](/farming/cli/install)** - Command-line interface for advanced users seeking full control and automation capabilities
+- **[Space Acres](/farming/space-acres/install)** <Badge variant="recommended" text="Recommended" /> - User-friendly GUI application that simplifies farming with visual setup, monitoring, and the most common configuration options
+- **[CLI](/farming/cli/install)** - Command-line interface for advanced users needing multiple farms, farming clusters, or specialized configuration options
 
 ### <Icon icon={ICONS.NOMINATOR} />Nominators
 Stake your tAI3 tokens by nominating operators to increase their chances of being elected as slot leaders. Earn proportional rewards while supporting network security.