docs: document Jira TaskSpawner fields

[zerone0x]

What type of PR is this?

/kind docs

What this PR does / why we need it:

Documents the missing Jira TaskSpawner source fields in docs/reference.md so users can configure Jira without reading the API types.

Adds reference rows for:

• spec.when.jira.baseUrl
• spec.when.jira.project
• spec.when.jira.jql
• spec.when.jira.secretRef.name

Which issue(s) this PR is related to:

Fixes #1061
Also addresses part of #777

Special notes for your reviewer:

Kept this scoped to the field-level reference gap from #1061. Jira secret details already exist in docs/integration.md.

Does this PR introduce a user-facing change?

Document missing Jira TaskSpawner source fields in the API reference.

[cubic-dev-ai]

No issues found across 1 file

[greptile-apps]

Greptile Summary

This PR adds four previously-undocumented spec.when.jira.* reference rows (baseUrl, project, jql, secretRef.name) to docs/reference.md. The descriptions were verified against internal/source/jira.go and accurately reflect the implementation's auth logic and JQL construction.

Confidence Score: 5/5

This is a documentation-only PR with no code changes; safe to merge.

All four new field descriptions were verified against the jira.go implementation and are accurate. No P0 or P1 issues found.

No files require special attention.

Important Files Changed

Filename	Overview
docs/reference.md	Adds four missing Jira TaskSpawner field rows (baseUrl, project, jql, secretRef.name) in the correct position before the existing pollInterval row; descriptions are consistent with the jira.go implementation

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["spec.when.jira config"] --> B["baseUrl\n(required)"]
    A --> C["project\n(required)"]
    A --> D["jql\n(optional)"]
    A --> E["secretRef.name\n(required)"]
    A --> F["pollInterval\n(optional)"]

    D -->|"jql is empty"| G["query: project = PROJECT"]
    D -->|"jql set, no ORDER BY"| H["query: project = PROJECT AND (jql)"]
    D -->|"jql set, with ORDER BY"| I["query: project = PROJECT AND (filter) ORDER BY ..."]

    E --> J["JIRA_TOKEN (required)"]
    E --> K["JIRA_USER (optional)"]
    K -->|"present"| L["Basic auth\n(Jira Cloud)"]
    K -->|"absent"| M["Bearer auth\n(Jira DC/Server)"]

Loading

_{Reviews (2): Last reviewed commit: "docs: document Jira TaskSpawner fields" | Re-trigger Greptile}