Numbered parameters become fragile quite fast for even simple queries. Basically you couldn't safely use query until carefully revising a template. A template change could potentially break existing queries. It's kinda scary.
If library supports named parameters they should be used by default in examples.
If library supports named parameters they should be used by default in examples.