Problem
The section ## Calling canisters that require cycles in guides/canister-management/cycles-management.mdx is misplaced. It covers a call mechanic (attaching cycles to an inter-canister call), not an operational management concern. The cycles-management guide otherwise covers acquiring cycles, checking balances, topping up, freeze thresholds, and monitoring — all operational topics.
Proposed fix
Move the content into guides/canister-calls/inter-canister-calls.mdx as a new ## Calls with attached cycles section, covering:
- Attaching cycles when calling out (Motoko
(with cycles = amount) syntax, Rust .with_cycles())
- Accepting cycles when receiving a call
- Proxy canister pattern for attaching cycles from the CLI
Affected files
docs/guides/canister-management/cycles-management.mdx — remove the section
docs/guides/canister-calls/inter-canister-calls.mdx — add the section
docs/concepts/cycles.md — update link at line ~97 (currently cycles-management.md#calling-canisters-that-require-cycles)
docs/guides/chain-fusion/exchange-rates.mdx — update link in "Testing from the CLI" section
Notes
Problem
The section
## Calling canisters that require cyclesinguides/canister-management/cycles-management.mdxis misplaced. It covers a call mechanic (attaching cycles to an inter-canister call), not an operational management concern. The cycles-management guide otherwise covers acquiring cycles, checking balances, topping up, freeze thresholds, and monitoring — all operational topics.Proposed fix
Move the content into
guides/canister-calls/inter-canister-calls.mdxas a new## Calls with attached cyclessection, covering:(with cycles = amount)syntax, Rust.with_cycles())Affected files
docs/guides/canister-management/cycles-management.mdx— remove the sectiondocs/guides/canister-calls/inter-canister-calls.mdx— add the sectiondocs/concepts/cycles.md— update link at line ~97 (currentlycycles-management.md#calling-canisters-that-require-cycles)docs/guides/chain-fusion/exchange-rates.mdx— update link in "Testing from the CLI" sectionNotes
infra/learn-hub-migration-prep) is merged, as that PR touches several of the affected files.icp-cli-templates/proxyand is already documented in cycles-management; make sure the reference survives the move.