docs: fix guides and references

[marc0olo]

This PR fixes critical documentation errors discovered through comprehensive verification against the source code. All examples and configuration references now accurately reflect the actual implementation.

Critical Fixes

Recipe Parameter Corrections

Fixed incorrect parameter names across multiple documentation files to match official recipe implementations:

• Motoko recipe: Changed entry: → main:

  • docs/guides/using-recipes.md
  • docs/guides/creating-templates.md (3 occurrences)

• Asset canister recipe: Changed source: → dir: and standardized recipe type to @dfinity/asset-canister

  • docs/guides/using-recipes.md
  • docs/guides/creating-templates.md

Verification: Confirmed against official recipe templates

Sync Step Configuration Fixes

Corrected assets sync step field names to match the actual adapter implementation:

• Before: source: dist and target: /
• After: dir: dist

Files updated:

• docs/reference/configuration.md (inline example)
• docs/concepts/build-deploy-sync.md
• docs/guides/managing-environments.md

Verification: Source code at crates/icp/src/manifest/adapter/assets.rs confirms the adapter only supports dir or dirs fields.

Removed Non-Existent Build Adapter Documentation

Removed entire "Assets Step" section from Build Steps in docs/reference/configuration.md.

Reason: The assets adapter only exists for sync steps, not build steps. The BuildStep enum only supports Script and Prebuilt variants. The documented fields (source, target, include_patterns, exclude_patterns) do not exist in the codebase.

Script Name Corrections

Fixed references to schema generation script:

• Before: ./scripts/config-schemas.sh (README) and ./scripts/generate-config-schema.sh (CLAUDE.md - singular)
• After: ./scripts/generate-config-schemas.sh (correct plural form)

Files: README.md, .claude/CLAUDE.md

Enhanced Migration Guide (docs/migration/from-dfx.md)

Major improvements with +128 net lines:

1. Corrected identity storage paths with OS-specific locations:

   • macOS: ~/Library/Application Support/org.dfinity.icp-cli/identity/
   • Linux: ~/.local/share/icp-cli/identity/
   • Windows: %APPDATA%\icp-cli\data\identity\

2. Comprehensive identity migration instructions covering all three storage modes:

   • Keyring (default)
   • Password-protected
   • Plaintext

3. Asset canister build commands explaining dfx auto-builds vs icp-cli explicit configuration

4. Side-by-side tool usage with port conflict warning and solutions

5. Canister ID storage paths clarification for connected vs managed networks

Impact

Users will no longer encounter errors from following documentation examples. All YAML configuration examples now match:

• Source code implementation
• Official recipe templates
• Working examples in examples/ directory
• JSON schemas in docs/schemas/

[raymondk]

This stuff is actually correct.
You can specify a canister.yaml configuration and point to it from your icp.yaml

[marc0olo]

yes, I know. but I explicitly asked to provide the example for icp.yaml to avoid confusion here 🤔