Skip to content

chore: add a make doctor target that validates local toolchain versions #497

Description

Description

The Makefile and justfile both provide dev targets, and rust-toolchain.toml pins the Rust version (#32), but there's no single command a new contributor can run to check whether their local Rust, Node, and Soroban CLI versions all match what the project expects before they start debugging confusing build failures.

This is repository-level tooling, configuration, or process rather than application code, but that doesn't make it lower stakes: onboarding friction, unclear ownership, and process gaps are consistently what determines whether a project with this much surface area (two contract trees, two backend trees, two frontend apps, a static dashboard, and an active external contributor program) stays maintainable as it grows or slowly accumulates inconsistency that nobody has the full context to untangle.

Given that this repository is actively recruiting outside contributors through the Stellar Wave bounty program (this issue included), the quality of its repository-level scaffolding, from CONTRIBUTING.md to CODEOWNERS to its issue and PR templates, has a direct and measurable effect on how many contributors are able to land a change successfully on their first attempt versus giving up in the setup phase.

Requirements and context

  • Add a make doctor (and just doctor) target checking rustc --version, node --version, and soroban --version against expected ranges

Suggested execution

  1. Fork the repo and create a branch
    git checkout -b chore/makefile-doctor-target
    
  2. Implement changes
  1. Test and commit
  • Run make doctor locally and confirm it reports mismatches clearly

Example commit message

chore: add doctor target for toolchain version validation

Guidelines

  • Assignment required before starting
  • PR description must include: Closes #[issue_id]
  • Keep PR description professional and detailed

Activity

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

Metadata

Metadata

Assignees

Labels

Stellar WaveIssues in the Stellar wave program

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions