HYPERFLEET-1163 - docs: add v0.2.0 to v1.0.0 upgrade guide

[kuudori]

Summary

• Add comprehensive v0.2.0 → v1.0.0 upgrade guide covering all four areas: configuration, API contract, statuses contract, and operating model
• 22 breaking changes documented with before/after examples
• Breaking changes summary table at the top of the document
• Each section separates "what changed" from "required action"
• Fresh database requirement stated explicitly

Jira: HYPERFLEET-1163
Depends on: HYPERFLEET-1177 (breaking-change checklist, in Review)

AC Coverage

AC	Status
Covers all four areas	✅ Sections 1–4
Separates what changed / required action	✅ Every subsection
Breaking changes summary at top	✅ Summary table
Config before/after examples	✅ YAML blocks
API contract with before/after shapes	✅ JSON blocks
Fresh database statement	✅ §4.1
Adapter team review	⏳ Requesting

Open items

• Verify completeness against HYPERFLEET-1177 checklist after it merges
• Confirm Channel/Version endpoint request/response shapes from OpenAPI spec
• Confirm canonical field name: observed_time vs last_updated_time
• Adapter team representative review (Angel Marin)

Test plan

• markdownlint passes (CI will validate)
• Internal links resolve correctly
• Before/after examples are accurate per v0.2.0 and v1.0.0 behavior

[openshift-ci]

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign ciaranroche for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🚫 Excluded labels (none allowed) (2)

• do-not-merge/work-in-progress
• do-not-merge/hold

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Central YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Enterprise

Run ID: f17fd515-f2e3-45e6-99c2-f2683de0c396

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

✨ Simplify code

• Create PR with simplified code

---

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