On Alias Management page change username to bitbucket username (BB-2915)

Issue #3189 invalid
ManGoes Mobile
created an issue

Hi, in the Username Aliases management page that is currently up, it is not very clear what is meant by "Username" and what is meant by "Alias" - both of them are marked as compulsory.

For example, in the screenshot (attached with this issue) of this BitBucket help page http://confluence.atlassian.com/display/BITBUCKET/Setting+up+User+Aliasing+for+your+Repositories, it is quite self-explanatory what is meant by the two fields of the page - one is BitBucket username and another is External username.

However, it is not that//// self explanatory in the actual Username Aliases management page that is currently up in BitBucket repo admin page.

regards Rakib

Comments (8)

  1. Dylan Etkin


    Thanks for reporting the issue. I agree with david that the documentation needs to be cleaned up.

    However I think that username / alias is pretty clear. The usual way to end up on that page is when you click the question mark on the commit page and then the information is filled out, making the form even more clear.

    We are going to leave this for now but thanks for reporting.



  2. Syed Rakib Al Hasan


    I took my time to make the attached png file to illustrate my understanding of the whole thing as, honestly, it is still not clear to me from the documentation. The terms used in the actual username/alias admin page are not as clear as the terms seen in the help page.

    Please help me out on this one. Thanks.


  3. David Chambers

    I have two problems with the old wording, both pertaining to the alias field's label:

    1. External. External to what? External to Bitbucket, I assume, but this is misleading since repositories and their contents are very much internal to Bitbucket.
    2. Username. This word implies that a third-party service is involved. The word "alias" is apt: Apple's dictionary states that it's "used to indicate that a named person is also known or more familiar under another specified name".

    I'm not claiming that the current wording is perfect, but it would be a mistake to revert to the old wording. Perhaps we could change "Username" to "Bitbucket username" and call it a day?

  4. Log in to comment