fix: documentation about connections. Fixes issue #313

[arora-saurabh448]

Summary

Fixed documentation to solve issue #313

Test Plan

How was this tested?

Checklist

• Documentation updated (if needed)

Summary by CodeRabbit

• Documentation
  • Updated warehouse configuration guidance to reflect new .altimate-code/connections.json file location.
  • Simplified connection configuration JSON structure with connections at the root level instead of nested under a "warehouses" key.
  • Clarified project-local and global configuration file paths.

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 13bb6978-becd-473f-9851-8d39ceedf008

📥 Commits

Reviewing files that changed from the base of the PR and between c734e19 and 8b9d69b.

📒 Files selected for processing (6)

• docs/docs/configure/warehouses.md
• docs/docs/getting-started.md
• docs/docs/getting-started/quickstart-new.md
• docs/docs/getting-started/quickstart.md
• docs/docs/quickstart.md
• docs/docs/reference/windows-wsl.md

Disabled knowledge base sources:

• Jira integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Walkthrough

Documentation updates across multiple guides to reflect a new warehouse connection configuration structure, moving from altimate-code.json with a "warehouses" wrapper to a separate .altimate-code/connections.json file with connector definitions at the root level.

Changes

Cohort / File(s)	Summary
Getting Started & Quickstart Guides docs/docs/getting-started.md, docs/docs/getting-started/quickstart-new.md, docs/docs/getting-started/quickstart.md, docs/docs/quickstart.md	Updated configuration examples and file path references from altimate-code.json to .altimate-code/connections.json; removed top-level "warehouses" and "connections" wrapper objects, placing connector definitions (Snowflake, BigQuery, PostgreSQL, DuckDB, etc.) directly at the root level of the JSON.
Warehouse Configuration Reference docs/docs/configure/warehouses.md	Comprehensive update to all warehouse connection examples (generic, Snowflake variants, BigQuery, Databricks, PostgreSQL, Redshift, DuckDB, MySQL, SQL Server, SSH tunneling) removing the "warehouses" wrapper; clarified config file locations specifying .altimate-code/connections.json as project-local and ~/.altimate-code/connections.json as global.
Troubleshooting & WSL Reference docs/docs/reference/windows-wsl.md	Updated forward-slash path formatting guidance to reference .altimate-code/connections.json; adjusted DuckDB local configuration example to remove the warehouses wrapper and place the connection at root level.

Poem

🐰 Connection configs hop to a new home,
From .altimate-code.json to connections.json to roam,
No more wrappers binding tight,
Just connectors at the root—oh what a sight!
Docs all aligned in perfect array,
Configuration clarity wins the day! ✨

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/docs-connection

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}