Skip to content

docs: second-pass hardening — fix stale versions, broken refs, and incorrect Quick Start commands#19

Merged
dfeen87 merged 1 commit intomainfrom
copilot/optimize-documentation-for-onboarding
Apr 5, 2026
Merged

docs: second-pass hardening — fix stale versions, broken refs, and incorrect Quick Start commands#19
dfeen87 merged 1 commit intomainfrom
copilot/optimize-documentation-for-onboarding

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 5, 2026

Documentation polish pass correcting factual errors introduced or left unresolved after the first hardening round. No source code changes.

Version consistency

  • CHANGELOG.md: VERSION file value listed as (2.4.0) inside the [3.2.0] release entry → (3.2.0)
  • CITATION.cff: year: 2025year: 2026 (matches Copyright (c) 2026 in LICENSE)
  • docs/TELEMETRY_DASHBOARD.md: three stale v2.3/v2.3.0 references → v3.2/v3.2.0
  • docs/contracts/TELEMETRY_STORAGE_CONTRACT.md: (RAPS v2.3.0) in contract version line → (RAPS v3.2.0)

Broken file reference

TELEMETRY_STORAGE_CONTRACT.md referenced docs/telemetry_dashboard_v2.3.md (does not exist) → docs/TELEMETRY_DASHBOARD.md

Incorrect Quick Start commands

README.md Quick Start implied hlv_rtos_demo and rest_api_demo are produced by the SIL CMake build — they are not.

  • RTOS demo: replaced misleading ./build/hlv_rtos_demo snippet with prose clarifying it is a platform-specific reference example with no standalone CMake target
  • REST API demo: added correct build commands (cmake -S examples/api_client -B build/api_demo && cmake --build build/api_demo && ./build/api_demo/rest_api_demo)
  • curl example: /api/status endpoint does not exist → /health

Formatting & completeness

  • docs/architecture.md: missing # System Architecture title; dangling final sentence "All timing and common scalar types are centralized in:" completed with the actual path src/common/types.hpp
  • docs/sil_hil.md: ASCII architecture diagram was unformatted raw text; wrapped in a code fence and fixed misaligned (SIL)/(HIL) labels

…correct Quick Start commands

Agent-Logs-Url: https://github.com/dfeen87/HLV-RAPS/sessions/e29aafbb-fba9-411a-b53b-7b49b7632a5c

Co-authored-by: dfeen87 <158860247+dfeen87@users.noreply.github.com>
@dfeen87 dfeen87 marked this pull request as ready for review April 5, 2026 15:20
Copilot AI review requested due to automatic review settings April 5, 2026 15:20
@dfeen87 dfeen87 merged commit 23f1232 into main Apr 5, 2026
3 checks passed
@dfeen87 dfeen87 deleted the copilot/optimize-documentation-for-onboarding branch April 5, 2026 15:20
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documentation-only hardening pass to correct stale version references, fix a broken doc reference, and update Quick Start commands so they match the actual build targets and REST API endpoints.

Changes:

  • Correct version strings across docs/metadata (v2.3 → v3.2, and CITATION year 2025 → 2026).
  • Fix a broken telemetry dashboard doc reference in the telemetry storage contract.
  • Update README Quick Start: clarify RTOS demo build expectations, correct REST API demo build/run steps, and fix the curl endpoint to /health.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
README.md Fixes Quick Start commands and endpoint to reflect actual API demo build/run + /health.
docs/TELEMETRY_DASHBOARD.md Updates telemetry/dashboard doc to v3.2/v3.2.0 and adjusts future-version note.
docs/sil_hil.md Wraps SIL/HIL diagram in a code fence and corrects alignment/labels.
docs/contracts/TELEMETRY_STORAGE_CONTRACT.md Updates contract’s referenced RAPS version and fixes the telemetry dashboard file reference.
docs/architecture.md Adds missing top-level title and completes the “types” sentence with the correct path.
CITATION.cff Updates citation year to 2026 for consistency with repository licensing.
CHANGELOG.md Corrects the VERSION file value shown under the [3.2.0] release entry.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants