v1 Unit 5: Documentation and v1.0.0

[mairas]

Part of the shared-workflows v1 plan (tracking issue: issue 49).

Goal: README and examples describe only the v1 interface; v1.0.0 and v1 exist.

Requirements: R3

Dependencies: Units 2–4 verified on canaries

Files:

• Modify: README.md (rewrite per-workflow sections and input tables; migration guide from @main)
• Delete: examples/cockpit-apt/
• Modify: examples/docs-repo/.github/workflows/translation-status.yml (pin @v1)
• Tag-only repositories use the npm example's pr.yml and main.yml; no separate example

Approach: Tables generated by reading the workflow inputs, not copied from the old README. Migration guide maps each legacy input to its v1 replacement.

Test expectation: none -- documentation; lint from Unit 1 covers example YAML.

Verification: Every input in every workflow_call appears in the README with the YAML default.

[mairas]

Plan shift: no examples/tag-only/. Its pr.yml and main.yml would be identical to the npm example's, so the README (PR 66) tells tag-only repositories to use those two files without release.yml. The unit also repins examples/docs-repo to @v1. v1.0.0 and v1 wait for the rc canaries in issue 55.