Skip to content

[DOCUMENTATION] Write troubleshooting guide for common setup issues #374

@dev-fatima-24

Description

@dev-fatima-24

Priority: medium

Description

The docs/TROUBLESHOOTING.md file exists but only covers 3 issues. The most common contributor problems (Rust WASM target missing, Stellar CLI version mismatch, PostgreSQL connection refused, Freighter not detecting testnet) must be documented with step-by-step solutions.

Acceptance Criteria

  • At least 15 common issues documented with symptoms, cause, and solution
  • Issues organized by component (contracts, backend, frontend, oracle)
  • Each issue includes the exact error message to search for
  • Solutions are tested and verified to work
  • Guide links to relevant official documentation for deeper reading

Metadata

Metadata

Labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions