let aliasing fixes, docs, tests