Roopksaini/improved landing+quickstart (#113)

* updated-quickstart

* polished-landing-page

* workflow-update

* fixed-over-bolding

* link-update

Author: roopksaini

docs/README.md

@@ -1,64 +1,96 @@
-# iTwin CLI Manual
+# Welcome to iTwin CLI
 
-Welcome to the **iTwin CLI Manual**. This guide will help you get started with the iTwin CLI, a command-line tool designed to automate workflows, manage iTwins and iModels, and streamline interactions with the iTwin Platform.
+This guide will help you get started with the [iTwin CLI](https://github.com/iTwin/itwin-cli) — a command-line tool designed to streamline interactions with the iTwin Platform, manage iTwins and iModels, and automate your digital twin workflows.
+
+> 💡 New to iTwins? Check out our [iTwin 101 guide](itwin101.md) for an introduction to the platform.
 
 ## What is the iTwin CLI?
 
 The iTwin CLI enables users to:
 
-- Create and manage iTwins and iModels for digital twin projects.
-- Automate data workflows, such as synchronizing design files and tracking changes.
-- Manage access control by organizing users, assigning roles, and setting permissions.
-- Organize and store data within iTwin storage and repositories.
+- Interact with the iTwin Platform through simple commands
+- Create and manage iTwins and iModels for your digital twin projects
+- Organize and store data using iTwin storage and repositories
+- Manage access control by organizing users, assigning roles, and setting permissions
+- Automate data workflows, such as synchronizing design files and tracking changes
 
 Whether you're a first-time user or an experienced developer, this CLI provides essential commands to optimize your iTwin workflows.
 
 ---
 
 ## Installation
 
-To install the iTwin CLI, follow these steps:
+Getting started with the iTwin CLI is quick and easy. Here's how to install it on your system:
 
 1. **Download the Installer**  
-   Visit the [iTwin CLI Releases](https://github.com/itwin/itwin-cli/releases) page and download the latest version for your operating system.
+   Head over to the [iTwin CLI Releases](https://github.com/iTwin/itwin-cli/releases/latest) page and grab the latest version for your operating system.
 
 2. **Run the Installer**  
-   - **Windows**: Run the `.exe` file and follow the prompts.  
-   - **macOS**: Open the `.pkg` file to install.  
+   The installation process varies depending on your system:
+   - **Windows**: Double-click the `.exe` file and follow the installation wizard.
+   - **macOS**: Open the `.pkg` file and complete the installation steps. 
    - **Linux**: Extract the `.tar.gz` file and run:
      ```bash
      sudo ./install.sh
      ```
 
-3. **Verify Installation**  
-   After installation, check if the CLI is set up correctly:
+3. **Verify Your Installation**  
+   To make sure everything is set up correctly, open your terminal and run:
    ```bash
    itp --version
    ```
-   This should display the installed version.
+   You should see the version number of your installed CLI. If you get a `command not found` error, you might need to restart your terminal or check your system's PATH.
+
+> 💡 Need help? Visit our [GitHub issues](https://github.com/iTwin/itwin-cli/issues) to get support.
 
 ---
 
 ## Authentication
 
-Before using the iTwin CLI, authenticate your session.
+Before you can use the iTwin CLI, you'll need to log in. This authenticates your session and allows you to securely interact with the iTwin Platform.
 
-Use the following command to log in:
+To log in, simply run:
 ```bash
 itp auth login
 ```
 
-This will open a browser window for authentication. Once logged in, your session will remain active, allowing you to execute authenticated commands.
+This will open your default browser for authentication. Once you're logged in, your session will remain active, so you won't need to log in again for a while.
 
-To check if you’re logged in, run:
+To verify your login status, run:
 ```bash
 itp user me
 ```
 
-This will display your account details.
+This will show your account details, confirming you're properly authenticated.
 
----
+> 💡 For more specialized authentication workflows, see [itp auth login](auth/login.md).
 
 ## Quickstart
 
-If you're new to the iTwin CLI, check out the **[Quickstart](quickstart.md)** for a step-by-step walkthrough of setting up an iTwin, creating an iModel, and adding design data.
+Ready to dive in? Our [Quickstart guide](quickstart.md) will walk you through the essential steps:
+- Creating your first iTwin
+- Setting up an iModel
+- Adding design data
+- Viewing your model in 3D
+
+Perfect for new users, this guide gets you up and running in minutes.
+
+## Simplify your commands
+
+Want to make your commands shorter and more efficient? Our [Environment guide](environment.md) shows you how to:
+- Set default IDs using environment variables
+- Save IDs locally using the context system
+- Automatically save IDs when creating new iTwins and iModels
+
+This simplifies your workflow and keeps your commands concise.
+
+## Explore common workflows
+
+Ready to tackle real-world scenarios? Our [workflows section](workflows/overview.md) walks you through common use cases:
+- ⚡ [Automate iModel updates](workflows/imodel-automate-update.md)
+- 📂 [Manage iTwin repositories](workflows/itwin-add-repositories.md)
+- 🔑 [Control user permissions](workflows/itwin-group-access.md)
+- 📊 [Track project progress](workflows/itwin-script-progress-tracker.md)
+- 🔄 [Compare changesets](workflows/imodel-changeset-compare.md)
+
+These guides provide step-by-step instructions for specific tasks and scenarios.

docs/_sidebar.md

@@ -1,4 +1,4 @@
-* [iTwin CLI Manual](/docs/)
+* [iTwin CLI](/docs/)
 * [iTwin 101](/docs/itwin101.md)
 * [Quickstart](/docs/quickstart.md)
 * [Environment](/docs/environment.md)

docs/itwin101.md

@@ -67,14 +67,14 @@ Need to connect to a custom database, web API, or document store? The iTwin is d
 
 The **iTwin CLI** is a command-line tool that lets developers and technical users interact with the iTwin Platform through simple text commands. It simplifies many common tasks:
 
-- ✍️ **Create and manage iTwins**
-- 🛡️ **Set up access control and user roles**
-- 🔍 **Query or inspect metadata**
-- 📂 **Create iModels and populate them with design files**
-- 📰 **Track and compare changes with changesets**
-- 🔢 **Create named versions to mark project milestones**
-- ⇄ **Synchronize design data into the iModel**
-- 🌍 **Visualize the iTwin in Cesium Sandcastle**
+- ✍️ Create and manage iTwins
+- 🛡️ Set up access control and user roles
+- 🔍 Query or inspect metadata
+- 📂 Create iModels and populate them with design files
+- 📰 Track and compare changes with changesets
+- 🔢 Create named versions to mark project milestones
+- ⇄ Synchronize design data into the iModel
+- 🌍 Visualize the iTwin in Cesium Sandcastle
 
 It serves as a lightweight, scriptable gateway into a powerful ecosystem.
 

docs/quickstart.md

@@ -2,6 +2,8 @@
 
 The iTwin CLI allows you to interact with the iTwin Platform efficiently. This guide walks you through the essential first steps: **creating an iTwin, setting up an iModel, and populating it with design data.**
 
+> 💡 New to iTwins? Check out our [iTwin 101 guide](itwin101.md) for an introduction to the platform.
+
 ## Get Started with the iTwin Platform
 
 ### Step 0: Authenticate
@@ -16,41 +18,47 @@ itp auth login
 
 ### Step 1: Create an iTwin
 
-An iTwin represents a **digital twin** that organizes models, repositories, and data sources.
+An iTwin represents a **digital twin** that organizes models, repositories, and data sources. We'll use the `--save` flag to store the iTwin ID for future commands.
 
 ```bash
-itp itwin create --class Thing --sub-class Asset --name "My First iTwin"
+itp itwin create --class Thing --sub-class Asset --name "My First iTwin" --save
 ```
 
-**Result:** The command returns an *iTwin ID*, which you'll use in the next steps.
-
----
+**Result:** The command returns an *iTwin ID* and automatically saves it for future use. You won't need to specify this ID in subsequent commands.
 
 ### Step 2: Create an iModel
 
-An iModel stores design data and tracks changes over time. To create one, specify the *iTwin ID* from Step 1. 
+An iModel stores design data and tracks changes over time. We'll create one within our iTwin, and once again use the `--save` flag to store its ID for future commands.
 
 > Need a design file? Feel free to use the examples provided in the [iTwin CLI repository](https://github.com/iTwin/itwin-cli/tree/main/examples/datasets).
 
 ```bash
-itp imodel create --itwin-id your-itwin-id --name "My First iModel"
+itp imodel create --name "My First iModel" --save
 ```
 
-**Result:** You receive an *iModel ID* for future operations.
-
----
+**Result:** You receive an *iModel ID* which is automatically saved for future use.
 
 ### Step 3: Populate the iModel with Design Data
 
-Once your iModel is created, synchronize design files into it using the **populate** command.
+The populate command populates an iModel with design data from a given set of files. Since we already saved our iModel ID, we only need to specify the source file(s).
 
 ```bash
-itp imodel populate --imodel-id your-imodel-id --file file.dgn
+itp imodel populate --file file.dgn
 ```
 
 **Result:** Your design data is now available on the iTwin Platform. You can navigate to [My iTwins](https://developer.bentley.com/my-itwins/) on the iTwin Developer Portal to visualize it.
 
----
+### Step 4: View in Cesium Sandcastle (Bonus)
+
+Want to view your iModel in 3D? The CLI opens it on Cesium, where you can explore it in a geospatial environment.
+
+```bash
+itp imodel view cesium-sandcastle --open
+```
+
+**Result:** Your default browser opens with your iModel data displayed in 3D global context. You can orbit, zoom, and explore your design data in a rich geospatial environment.
+
+> 💡 Learn more about managing your iTwin and iModel IDs in our [Environment guide](environment.md).
 
 ## Next Steps
 
@@ -63,4 +71,4 @@ itp imodel populate --imodel-id your-imodel-id --file file.dgn
 
 ---
 
-🎉 **Congratulations!** You've successfully created an iTwin, set up an iModel, and populated it with data. Now you're ready to dive deeper into automation and integration!
+🎉 **Congratulations!** You've successfully created an iTwin, set up an iModel, populated it with data, and even viewed it in 3D. Now you're ready to dive deeper into iTwin workflows and automation!

docs/workflows/overview.md

@@ -1,5 +1,9 @@
 # Workflows
 
+Ready to put the iTwin CLI to work? These guides show you how to handle common tasks like project setup, team management, and automation.
+
+> 💡 The following are a few of the many possibilities.
+
 **Getting Started**
 - [Create and refine an iTwin](itwin-create.md)
 - [Create and refine an iModel](imodel-create.md)