add docs for alias + some issues