feat: add docs

[gummiorri]

Summary by cubic

Adds a Cobra-based docs generator and checks in LLM-friendly Markdown for the daco CLI under docs/cli. Improves command help text, adds doc-gen deps, and fixes spark-scala translator registration; fulfills “generate docs using Cobra” (Linear #71).

• New Features

  • New command: cmd/gendocs generates Markdown docs (default output: ./docs/cli); run with go run ./cmd/gendocs [output-dir].
  • Added long descriptions for root, ports, and connections commands to improve generated docs.
  • Committed generated docs for daco, init, connections (add/describe/list/remove), and ports (add/describe/list/remove/translate).

• Bug Fixes

  • Correctly wire spark-scala to sparkscala.Translator (was pointing to pyspark).
  • Fix ports translate help example to use --format gotypes instead of --format go.

^{Written for commit 66878be. Summary will update on new commits.}

[gummiorri]

@cubic-dev-ai review this

[cubic-dev-ai]

@cubic-dev-ai review this

@gummiorri I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

2 issues found across 17 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="cmd/gendocs/main.go">

<violation number="1" location="cmd/gendocs/main.go:48">
P2: The spark-scala format is wired to the PySpark translator, which will generate Python output in the docs for the Spark Scala format. Use the Spark Scala translator instead so the generated docs match the intended format.</violation>
</file>

<file name="docs/cli/daco_ports_translate.md">

<violation number="1" location="docs/cli/daco_ports_translate.md:25">
P3: The example uses `--format go`, but the documented valid formats list only includes `gotypes`. This makes the example misleading or invalid for users.</violation>
</file>

---

Since this is your first cubic review, here's how it works:

• cubic automatically reviews your code and comments on bugs and improvements
• Teach cubic by replying to its comments. cubic learns from your replies and gets better over time
• Ask questions if you need clarification on any suggestion

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

1 issue found across 17 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="docs/cli/daco_ports_translate.md">

<violation number="1" location="docs/cli/daco_ports_translate.md:25">
P3: Example uses `--format go`, but the documented valid formats list `gotypes` (and does not mention `go`). This makes the example misleading or invalid for users.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[giuseppegrieco]

LGTM