docs: update

Author: dubadub

docs/README.md

@@ -1,5 +1,3 @@
-# CookCLI Documentation
-
 The Cook CLI command line program provides a suite of tools to create shopping lists, maintain recipes, and manage your cooking workflow. We've built it to be simple and useful for automating your cooking and shopping routine with existing UNIX command line and scripting tools.
 
 ## Available Commands
@@ -27,6 +25,44 @@ cd cookcli
 cargo build --release
 ```
 
+## Global Options
+
+CookCLI supports several global options that apply to all commands:
+
+### Base Path
+Specify the directory containing your recipes (defaults to current directory):
+
+```bash
+# Use recipes from a specific directory
+cook --base-path ~/my-recipes recipe "Pizza.cook"
+
+# Short form
+cook -b ~/my-recipes shopping-list "Pasta.cook"
+```
+
+### Logging Verbosity
+Control the amount of debug information displayed:
+
+```bash
+# Normal output (default)
+cook recipe "Pizza.cook"
+
+# Info level logging (-v)
+cook -v recipe "Pizza.cook"
+
+# Debug level logging (-vv)
+cook -vv shopping-list "Pasta.cook"
+
+# Trace level logging (-vvv) - most verbose
+cook -vvv doctor validate
+```
+
+The logging levels are:
+* No flag: Normal output only
+* `-v`: Info messages
+* `-vv`: Debug messages (helpful for troubleshooting)
+* `-vvv`: Trace messages (detailed parsing and processing information)
+
 ## Quick Start
 
 Start by creating some sample recipes to explore:
@@ -43,6 +79,9 @@ cook shopping-list "Neapolitan Pizza.cook" "Caesar Salad.cook"
 
 # Start the web server
 cook server
+
+# Use recipes from another directory with debug logging
+cook -b ~/recipes -vv server
 ```
 
 ## Philosophy
@@ -59,9 +98,11 @@ Everything in CookCLI follows these principles:
 Recipes are stored as `.cook` files using the Cooklang markup language. Here's a simple example:
 
 ```cooklang
->> title: Simple Pasta
->> time: 20 minutes
->> servings: 2
+---
+title: Simple Pasta
+time: 20 minutes
+servings: 2
+---
 
 Bring @water{2%liters} to a boil in a large #pot.
 
@@ -147,4 +188,4 @@ cook shopping-list --help
 
 ## License
 
-CookCLI is open source software licensed under the [MIT License](https://github.com/cooklang/cookcli/blob/main/LICENSE).
+CookCLI is open source software licensed under the [MIT License](https://github.com/cooklang/cookcli/blob/main/LICENSE).

docs/import.md

@@ -4,6 +4,8 @@ The `import` command fetches recipes from websites and automatically converts th
 
 Requires `OPENAI_API_KEY` environment variable set to perform the conversion to Cooklang. Without the key you still can downlad recipe original content, but it won't be converted to Cooklang.
 
+Note that you can use [cook.md converter](https://cooklang.org/docs/getting-started#build-your-recipe-collection) if you don't have OpenAI key.
+
 ## Basic Usage
 
 ```bash