From 4a134b49ddad03649800bf53f20d6709ef72d0a2 Mon Sep 17 00:00:00 2001 From: hl-valdemar Date: Tue, 27 Oct 2026 11:06:06 +0100 Subject: [PATCH] docs: distinguish binding and pointee mutability --- docs/style.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/style.md b/docs/style.md index 1d3445b..c20c488 100644 --- a/docs/style.md +++ b/docs/style.md @@ -10,7 +10,7 @@ these guidelines apply to Honey programs, the compiler, and the standard library ## bindings and types -- prefer `::` for bindings that stay fixed; use `:=` for bindings that change, including values mutated through pointers. +- prefer `::` when the bound value stays fixed; use `:=` when the bound value changes. mutation through a mutable pointer or slice does not require rebinding and is not, by itself, a reason to use `:=`. - infer types when the initializer makes the intended type clear. write an explicit type when it determines representation, mutability, or a public contract. - request mutable pointers and slices only when the operation needs to modify their contents. - give aggregates meaningful defaults. use `undefined` only when every value that can be read is assigned first.