docs: env + strategy adjustment

Author: gildesmarais

.gitignore

@@ -16,6 +16,7 @@ pnpm-debug.log*
 # environment variables
 .env
 .env.production
+!examples/deployment/.env
 
 # macOS-specific files
 .DS_Store

src/content/docs/troubleshooting/troubleshooting.mdx

@@ -95,7 +95,7 @@ If parts of your items (e.g., title, link) are missing, check the following:
 
 - **Selector:** Ensure the selector for the missing part is correct and relative to the `items.selector`.
 - **Extractor:** Verify that you are using the correct `extractor` (e.g., `text`, `href`, `attribute`).
-- **Dynamic Content:** `html2rss` does not execute JavaScript. If the content is loaded dynamically, `html2rss` may not be able to see it.
+- **Dynamic Content:** `faraday` does not render JavaScript. If content loads dynamically, run with `--strategy browserless` (with the Browserless service available) so the page can be rendered before extraction.
 
 ### Date/Time Parsing Errors
 

src/content/docs/web-application/getting-started.mdx

@@ -49,7 +49,17 @@ This minimal stack intentionally proves the included-feed path first. Add automa
 
 ### Step 3: Start html2rss-web
 
-Run:
+Create a `.env` file in the same folder (minimum required values for this stack):
+
+```bash
+cat > .env <<EOF
+HTML2RSS_SECRET_KEY=$(openssl rand -hex 32)
+HEALTH_CHECK_TOKEN=$(openssl rand -hex 24)
+BROWSERLESS_IO_API_TOKEN=trial-browserless-token
+EOF
+```
+
+Then run:
 
 ```bash
 docker compose up -d