docs: improve readmes (#13)

Author: marc0olo

README.md

@@ -1,52 +1,80 @@
-# ICP Recipes
+# ICP CLI Recipes
 
-A comprehensive repository of Internet Computer (IC) canister build recipes using Handlebars templates.
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)
 
-## Overview
+Official build recipe templates for Internet Computer (ICP) canisters. Recipes provide standardized, reusable build configurations using Handlebars templates.
 
-This repository serves as the official Dfinity recipe repository for various ICP projects. Recipes are specified as Handlebars templates that generate build configurations for different types of IC canisters.
+## Available Recipes
 
-## Using Recipes
+| Recipe | Description |
+|--------|-------------|
+| [**Rust**](recipes/rust/README.md) | Build Rust canisters using Cargo with WASM target |
+| [**Motoko**](recipes/motoko/README.md) | Compile Motoko source code using the moc compiler |
+| [**Pre-built**](recipes/prebuilt/README.md) | Use pre-compiled WASM files with metadata injection |
+| [**Asset Canister**](recipes/asset-canister/README.md) | Deploy the official IC assets canister for frontend apps |
 
-Recipes are consumed by referencing them in your `icp.yaml` file:
+## Quick Start
+
+### Using a Recipe
+
+Reference a recipe in your `icp.yaml` file:
 
 ```yaml
 canister:
-  name: my-canister
+  name: backend
   recipe:
-    type: prebuilt
-    url: https://github.com/dfinity/icp-recipes/releases/download/v1.0.0/recipes/prebuilt/recipe.yml
+    type: "@dfinity/rust"
     configuration:
-      path: ../dist/my-canister.wasm
-      sha256: 17a05e36278cd04c7ae6d3d3226c136267b9df7525a0657521405e22ec96be7a
+      package: my-canister
+      shrink: true
 ```
 
-## Recipe Types
+### Recipe Naming Convention
+
+Recipes follow the `@dfinity/<recipe-name>` naming pattern:
+- `@dfinity/rust` - Rust canister recipe
+- `@dfinity/motoko` - Motoko canister recipe
+- `@dfinity/pre-built` - Pre-built WASM recipe
+- `@dfinity/asset-canister` - Asset canister recipe
 
-- **prebuilt**: For using pre-compiled WASM files
-- **assets**: For the official IC assets canister with asset synchronization
-- **motoko**: For compiling Motoko source code
-- **rust**: For building Rust canisters with Cargo
+### Using Specific Versions
+
+To pin to a specific recipe version, append `@<version>` to the recipe type:
+
+```yaml
+canister:
+  name: backend
+  recipe:
+    type: "@dfinity/rust@v3.0.0"
+    configuration:
+      package: my-canister
+```
 
-## Authoring Recipes
+Without a version specified, the latest stable version is used. View available versions in the [releases page](https://github.com/dfinity/icp-cli-recipes/releases).
 
-See [Recipe Authoring Guide](docs/recipe-authoring.md) for guidelines on creating new recipes.
+## Releases
 
-## Versioning
+Each recipe is versioned independently. View release history by recipe type:
+- [Rust releases](https://github.com/dfinity/icp-cli-recipes/releases?q=rust&expanded=true)
+- [Motoko releases](https://github.com/dfinity/icp-cli-recipes/releases?q=motoko&expanded=true)
+- [Pre-built releases](https://github.com/dfinity/icp-cli-recipes/releases?q=prebuilt&expanded=true)
+- [Asset Canister releases](https://github.com/dfinity/icp-cli-recipes/releases?q=asset-canister&expanded=true)
 
-This repository follows semantic versioning. Each release publishes recipe artifacts that can be referenced by URL.
+Releases follow semantic versioning and include auto-generated changelogs.
 
-## Future Roadmap
+## Documentation
 
-- [ ] Recipe validation framework
-- [ ] Advanced testing infrastructure
-- [ ] Template repository for creating custom recipe libraries
-- [ ] Enhanced documentation with interactive examples
-- [ ] Community recipe submission process
+- [Recipe Authoring Guide](docs/recipe-authoring.md) - Create custom recipes
+- [Recipe README Template](docs/recipe-readme-template.md) - Documentation template
 
 ## Contributing
 
-Contributions are welcome! Please see the [contribution guide](./.github/CONTRIBUTING.md) for more information.
+Contributions are welcome! Please see the [contribution guide](./.github/CONTRIBUTING.md) for details.
+
+## Support
+
+- Report issues: [GitHub Issues](https://github.com/dfinity/icp-cli-recipes/issues)
+- Questions & discussions: [DFINITY Developer Forum](https://forum.dfinity.org/)
 
 ## License
 

recipes/asset-canister/README.md

@@ -106,6 +106,6 @@ The assets canister automatically synchronizes files from your specified directo
 
 Use this recipe for frontend applications that need to serve static assets and web content on the Internet Computer.
 
-## Version History
+## Release History
 
-- v1.0.0 - Initial release with assets canister support and synchronization
+See the [release history](https://github.com/dfinity/icp-cli-recipes/releases?q=asset-canister&expanded=true) for changelogs, version updates, and breaking changes.

recipes/motoko/README.md

@@ -120,10 +120,10 @@ my-project/
 
 - [Rust Recipe](../rust/README.md) - For building Rust canisters
 - [Pre-built Recipe](../prebuilt/README.md) - For using pre-compiled WASM files
-- [Assets Recipe](../assets/README.md) - For frontend assets canister
+- [Asset Canister Recipe](../asset-canister/README.md) - For frontend assets canister
 
 Use this recipe when developing IC canisters in Motoko, the native language for the Internet Computer.
 
-## Version History
+## Release History
 
-- v1.0.0 - Initial release with Motoko compilation support
+See the [release history](https://github.com/dfinity/icp-cli-recipes/releases?q=motoko&expanded=true) for changelogs, version updates, and breaking changes.

recipes/prebuilt/README.md

@@ -98,10 +98,10 @@ When this recipe is executed:
 
 - [Rust Recipe](../rust/README.md) - For building Rust canisters from source
 - [Motoko Recipe](../motoko/README.md) - For building Motoko canisters from source
-- [Assets Recipe](../assets/README.md) - For the official IC assets canister
+- [Asset Canister Recipe](../asset-canister/README.md) - For the official IC assets canister
 
 Use this recipe when you have a pre-compiled WASM file and want to add metadata or optimize it without rebuilding from source.
 
-## Version History
+## Release History
 
-- v1.0.0 - Initial release with basic pre-built WASM support
+See the [release history](https://github.com/dfinity/icp-cli-recipes/releases?q=prebuilt&expanded=true) for changelogs, version updates, and breaking changes.

recipes/rust/README.md

@@ -147,10 +147,10 @@ serde = { version = "1.0", features = ["derive"] }
 
 - [Motoko Recipe](../motoko/README.md) - For building Motoko canisters
 - [Pre-built Recipe](../prebuilt/README.md) - For using pre-compiled WASM files
-- [Assets Recipe](../assets/README.md) - For frontend assets canister
+- [Asset Canister Recipe](../asset-canister/README.md) - For frontend assets canister
 
 Use this recipe when developing IC canisters in Rust, which provides performance benefits and access to the rich Rust ecosystem.
 
-## Version History
+## Release History
 
-- v1.0.0 - Initial release with Rust compilation support
+See the [release history](https://github.com/dfinity/icp-cli-recipes/releases?q=rust&expanded=true) for changelogs, version updates, and breaking changes.