add REST documentation for tenants module

Alias is referred to as `Unique identifier` and `Unique short name` in different places. We can probably change all terminology to be a "Unique short name" to avoid the "id" nomenclature which is usually referred to something in Hilary that has been randomly generated