Build/improve makefile

[ccamel]

Improves DX around build tooling and documentation by standardizing task naming, introducing categories, and adding a help task for better discoverability. Adds an automated readme task and a CI check to keep the README task list up to date.

Summary by CodeRabbit

• New Features

  • Added comprehensive help system documenting all available development tasks organized by category.
  • Added README validation to build pipeline.

• Documentation

  • Updated documentation generation command and process.
  • Enhanced README with categorized tasks reference guide.

• Chores

  • Reorganized development tooling setup and task structure for improved clarity.

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

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.

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

Walkthrough

This pull request restructures the build and documentation generation system by consolidating the docs-generate command into a docs task and extensively reorganizing the Makefile with new task categories, additional development tool installers, and improved task dependencies. Related workflow and configuration files are updated accordingly.

Changes

Cohort / File(s)	Summary
Documentation generation command unification .github/workflows/lint.yml, .releaserc.cjs, Makefile.toml, README.md	Replaces cargo make docs-generate with cargo make docs across CI workflows, release configuration, build system, and documentation. Updates lint job to validate documentation freshness and adds new README validation job.
Makefile task reorganization and expansion Makefile.toml	Introduces default help task, adds explicit category metadata to all tasks, consolidates lint tasks (lint-rust-clippy, composite lint-rust), adds install tasks for development tools (cranky, taplo-cli, llvm-cov, cosmwasm-check, cargo-workspaces, cargo-hack, cargo-machete, cargo-sort-derives), expands chain management and contract deployment/interaction tasks with improved parameter handling, and restructures documentation generation process.
README documentation update README.md	Adds comprehensive "Available Tasks" section with categorized task listings, updates documentation prerequisite heading, removes inline detailed chain task enumeration.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

The changes involve substantial structural reorganization of the primary build system with numerous new task dependencies, category introductions, and tool installer additions requiring careful verification. The heterogeneous nature—spanning workflows, CI configuration, the build manifest, and documentation—demands separate verification for each component's correctness and integration.

Possibly related PRs

• build(make): modularize prerequisites checks into subtasks #754: Modifies Makefile.toml prerequisite tooling and documentation generation tasks; this PR's restructuring of docs generation and tool installers overlaps with that PR's dependency management approach.

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Title Check	❓ Inconclusive	The title "Build/improve makefile" is technically related to the changeset, as the PR does involve extensive makefile modifications. However, the title is vague and uses non-descriptive language that fails to convey what specific improvements were made. The PR accomplishes concrete objectives—standardizing task naming, introducing task categories, adding a help task for better discoverability, implementing automated README generation, and adding CI checks for README validation—none of which are reflected in the title. A developer scanning the repository history would not understand the specific nature or scope of these improvements based solely on this title, as "improve makefile" could apply to numerous types of changes.	Consider revising the title to be more specific and descriptive of the primary improvements. For example: "Restructure makefile with task categories and automated README generation" or "Standardize makefile tasks and add developer help tooling" would better communicate the actual changes and improve discoverability when reviewing commit history.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[bot-anik]

size-limit report 📦

Path	Size
target/wasm32-unknown-unknown/release/axone_dummy.wasm	230.31 KB (0%)