update the docs to include aliasing