docs(README.md): move Getting Started to README and improve clarity of the section

Closes #1405

Author: bearomorphism

docs/README.md

@@ -48,81 +48,168 @@ This standardization makes your commit history more readable and meaningful, whi
 - Display information about your commit rules (commands: schema, example, info)
 - Create your own set of rules and publish them to pip. Read more on [Customization](./customization.md)
 
-## Requirements
+## Getting Started
 
-[Python](https://www.python.org/downloads/) `3.9+`
+### Requirements
 
-[Git][gitscm] `1.8.5.2+`
+Before installing Commitizen, ensure you have:
 
-## Installation
+- [Python](https://www.python.org/downloads/) `3.9+`
+- [Git][gitscm] `1.8.5.2+`
 
-Install commitizen in your system using `pipx` (Recommended, <https://pypa.github.io/pipx/installation/>):
+### Installation
+
+#### Global Installation (Recommended)
+
+The recommended way to install Commitizen is using `pipx`, which ensures a clean, isolated installation:
 
 ```bash
+# Install pipx if you haven't already
 pipx ensurepath
+
+# Install Commitizen
 pipx install commitizen
+
+# Keep it updated
 pipx upgrade commitizen
 ```
 
-Install commitizen using `pip` with the `--user` flag:
+If you're on macOS, you can also install Commitizen using Homebrew:
 
 ```bash
-pip install --user -U commitizen
+brew install commitizen
 ```
 
-### Python project
+#### Project-Specific Installation
 
-You can add it to your local project using one of the following methods.
+You can add Commitizen to your Python project using any of these package managers:
 
-With `pip`:
+**Using pip:**
 
 ```bash
 pip install -U commitizen
 ```
 
-With `conda`:
+**Using conda:**
 
 ```bash
 conda install -c conda-forge commitizen
 ```
 
-With Poetry >= 1.2.0:
+**Using Poetry:**
 
 ```bash
+# For Poetry >= 1.2.0
 poetry add commitizen --group dev
+
+# For Poetry < 1.2.0
+poetry add commitizen --dev
 ```
 
-With Poetry < 1.2.0:
+### Basic Commands
 
-```bash
-poetry add commitizen --dev
+#### Initialize Commitizen
+
+To get started, you'll need to set up your configuration. You have two options:
+
+1. Use the interactive setup:
+```sh
+cz init
 ```
 
-### macOS
+2. Manually create a configuration file (`.cz.toml` or `cz.toml`):
+```toml
+[tool.commitizen]
+version = "0.1.0"
+update_changelog_on_bump = true
+```
 
-via [homebrew](https://formulae.brew.sh/formula/commitizen):
+#### Create Commits
 
-```bash
-brew install commitizen
+Create standardized commits using:
+```sh
+cz commit
+# or use the shortcut
+cz c
 ```
 
-## Usage
+To sign off your commits:
+```sh
+cz commit -- --signoff
+# or use the shortcut
+cz commit -- -s
+```
 
-Most of the time, this is the only command you'll run:
+For more commit options, run `cz commit --help`.
 
+#### Version Management
+
+The most common command you'll use is:
 ```sh
 cz bump
 ```
 
-On top of that, you can use commitizen to assist you with the creation of commits:
+This command:
+- Bumps your project's version
+- Creates a git tag
+- Updates the changelog (if `update_changelog_on_bump` is enabled)
+- Updates version files
+
+You can customize:
+- [Version files](./commands/bump.md#version_files)
+- [Version scheme](./commands/bump.md#version_scheme)
+- [Version provider](./config.md#version-providers)
+
+For all available options, see the [bump command documentation](./commands/bump.md).
+
+### Advanced Usage
+
+#### Get Project Version
 
+To get your project's version (instead of Commitizen's version):
 ```sh
-cz commit
+cz version -p
+```
+
+This is particularly useful for automation. For example, to preview changelog changes for Slack:
+```sh
+cz changelog --dry-run "$(cz version -p)"
+```
+
+#### Pre-commit Integration
+
+Commitizen can automatically validate your commit messages using pre-commit hooks.
+
+1. Add to your `.pre-commit-config.yaml`:
+```yaml
+---
+repos:
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: master  # Replace with latest tag
+    hooks:
+      - id: commitizen
+      - id: commitizen-branch
+        stages: [pre-push]
+```
+
+2. Install the hooks:
+```sh
+pre-commit install --hook-type commit-msg --hook-type pre-push
 ```
 
-Read more in the section [Getting Started](./getting_started.md).
+| Hook              | Recommended Stage |
+| ----------------- | ----------------- |
+| commitizen        | commit-msg        |
+| commitizen-branch | pre-push          |
+
+> **Note**: Replace `master` with the [latest tag](https://github.com/commitizen-tools/commitizen/tags) to avoid warnings. You can automatically update this with:
+> ```sh
+> pre-commit autoupdate
+> ```
 
-### Help
+For more details about commit validation, see the [check command documentation](commands/check.md).
+
+## Usage
 
 <!-- Please manually update the following section after changing `cz --help` command output. -->
 

docs/getting_started.md

@@ -31,7 +31,6 @@ edit_uri: ""
 
 nav:
   - Introduction: "README.md"
-  - Getting Started: "getting_started.md"
   - Commands:
       - init: "commands/init.md"
       - commit: "commands/commit.md"