docs: descriptive installation guide

Author: akhundMurad

docs/quickstart.md

@@ -10,23 +10,29 @@ It is intentionally short. The goal is to get you productive quickly, not to exp
 
 Install the package using your preferred tool.
 
-With pip:
+- Standard installation (uses `uuid6` library):
 
-```bash
-pip install typeid-python
-```
+    ```console
+    $ pip install typeid-python
+    ```
 
-With uv:
+- Rust acceleration (`uuid-utils` + Rust base32 encode/decode):
 
-```bash
-uv add typeid-python
-```
+    ```console
+    $ pip install "typeid-python[rust]"
+    ```
 
-If you plan to use YAML schemas later, install the optional extra:
+- YAML schemas support:
 
-```bash
-pip install "typeid-python[yaml]"
-```
+    ```console
+    $ pip install "typeid-python[yaml]"
+    ```
+
+- CLI features:
+
+    ```console
+    $ pip install "typeid-python[cli]"
+    ```
 
 JSON schemas work without any extras.
 

pyproject.toml

@@ -27,10 +27,7 @@ dependencies = ["uuid6>=2024.7.10,<2026.0.0"]
 [project.optional-dependencies]
 cli = ["click"]
 yaml = ["PyYAML"]
-rust = [
-  "uuid-utils>=0.12.0",
-  "maturin>=1.5; platform_system != 'Windows'",  # optional; for local dev only
-]
+rust = ["uuid-utils>=0.12.0"]
 
 [project.urls]
 Homepage = "https://github.com/akhundMurad/typeid-python"
@@ -57,6 +54,7 @@ dev = [
     "mkdocs-section-index>=0.3.10",
     "pytest-markdown-docs>=0.9.0",
     "pytest-benchmark>=5.0.1",
+    "maturin>=1.5; platform_system != 'Windows'"
 ]
 
 [tool.hatch.build.targets.sdist]