EasyMercurial

h1. Feedback from the 16/March Workshop

h2. code.soundsoftware

* No main link from front page http://www.soundsoftware.ac.uk/

_True, we should probably think about promoting it a bit more by now -- perhaps after this round of fixes!_

* Go to projects, search for "Easy" - not useful result (should give the project first)

_True, I'm not sure what the ordering is -- the projects are there, but not listed first_

* On http://code.soundsoftware.ac.uk/projects/easyhg/wiki/InstallingEasyHg, it says that Windows release is highlighed on http://code.soundsoftware.ac.uk/projects/easyhg/files, but actually several are highlighted.

_The install page is a stopgap for a proper website, agreed it's rather clumsy at the moment_

* On http://code.soundsoftware.ac.uk/projects/easyhg, the "Download" link is too far down, make it a big "Download" button at the top!

_There is a download button at the top. Evidently prominence rather than height on the page is the issue here_

* On https://code.soundsoftware.ac.uk/projects/qm-test-project-mdp/settings, please add help to what different roles do.

_Yes, this seems to have caused much confusion_

* Have an option to get sent email when added to a project

_Definitely -- slightly surprised this didn't happen already_

* In Repository " This URL has Read+Write access." Is meaningless to user

_This is issue #70_

* In Repository " your preferred Mercurial client" could be EasyMercurial.

_Yes, ultimately_

* In Repository "Mercurial" is not a link

_True, it should be_

* When empty, could say "no files yet"?

_Possibly_

* Provide 2 URLs, like Doodle does

_I don't know Doodle but apparently the suggestion is for "your URL" and "general URL to give to other people"_

* URL box easyhg is too short for https://markp@code.soundsoftware.ac.uk/hg/qm-test-project-mdp

_Don't understand this one_

* On repository, e.g. https://code.soundsoftware.ac.uk/projects/qm-test-project-mdp/repository, when click on file name, allow "open" or "preview" for text files etc, not just "download" (which enforces save).

_Don't understand this, the page has View and Annotate as well as Download_

* disable other languages 

_Right, or provide language fallbacks (I think this may be working in trunk code)_

* Entering a name [in Add User page for project] then typing enter gives an error message - reason code missing

_Right, this is pretty weird -- form should just do nothing if no people are selected_

h2. EasyHg

* On re-run (after install), it opens "Open Repository" dialog, but the default local Mercurial repostitory location is C:/Program Files (x86)/EasyMercurial, but should be e.g. C:/Users/[username]/My Documents (at least for 64-bit Windows 7).

_This should be fixed already in Hg, but I haven't tested it on Windows yet_

* Remote repository defaults to " C:/Program Files (x86)/EasyMercurial"

_Yes, this is quite wrong_

* Add text on the remote repository dialogue to instruct users to add the username to the remote repo URL "username@repository"

_Better added to code.soundsoftware page I think?_

* Local folder defaults to C:/Users/markp, should default to C:/Users/markp/My Documents

_This should be fixed in Hg_

* Local folder browse doesn't start from right place. E.g. Folder is " C:/Users/markp/My Documents/ ", click "Browse", shows C:\Program Files (x86)\EasyMercurial instead.

_I'll review this_

* On windows, can't select a folder with "Browse" unless it exists, so why complain that it already exists? It now says I cannot clone to it!

_This is #92, fixed in Hg_

* On cancel, Open Repository dialog forgets past state.

_This may be trickier than it looks to fix_

* What "password" do I type? Is this for my PC or for the repository, or creating a new one for the project?

_Good point, it should at least say "repository password" or something_

* Clone succsessful - more details is now wide enough (or should wrap text)

_Low priority!_

* .hg directory not hidden on windows - should tell people to ignore it!

_True... but where?_

* Commit to "local" repository - why? In Commit files dialog, maybe say its going to the local repository. Also, what is the "default branch"?

_I think the first point here is part of the general background that the user simply needs to know. Commit in a DVCS always goes to the local repository, that's just about the first thing you should learn, and I think the user would very quickly tire of always being reminded of it._

* Commit doesn't use file selection, uses all files. (Can commit individually with right-click).

_Correct, this is a recent intentional change -- using the selection was a cause of far more confusion in users who then couldn't see how to commit all files_

* keyboard shortcuts don't work on right-click menus, e.g. right-click button then "d" should to diff.

_Wow, I didn't know that ever worked in menus.  Agreed though, shortcuts are very lacking throughout_

* Push should warn on modified, uncommitted files. (Currently allows push with modified files).

_True_

* Pushed 1 changeset dialog details text is too small.

_Low priority -- all the "More Details" texts are supposed to be for troubleshooting only really_

* Folder dialog uses "/" not "\"?

_Not sure which dialog is referred to here? Windows actually uses / and \ interchangeably internally so this is never "wrong", but granted it's probably not helpful either_

* Why does "open" say "Clone successful"? Does "open" = "Clone"?

_Very good point_

* Commit files dialog box doesn't close on enter. Also can't use TAB to get to enter button. What's keyboard shortcut to commit?

_It certainly doesn't close on enter -- that would be very dangerous!  Not being able to tab is a problem though, I agree.  There's no shortcut for it in this dialog at the moment._

* On commit, I get Command Failed:

<pre>

warning: code.soundsoftware.ac.uk certificate not verified (check web.cacerts config setting)

warning: code.soundsoftware.ac.uk certificate not verified (check web.cacerts config setting)

warning: code.soundsoftware.ac.uk certificate not verified (check web.cacerts config setting)

warning: code.soundsoftware.ac.uk certificate not verified (check web.cacerts config setting)

warning: code.soundsoftware.ac.uk certificate not verified (check web.cacerts config setting)

warning: code.soundsoftware.ac.uk certificate not verified (check web.cacerts config setting)

abort: authorization failed

If not authorized, suggest ask the project manager to make sure you have access rights.

_That's quite a good idea_

</pre>

* it would be important to store the password for the session duration;

_This is what the "Keyring Extension":http://mercurial.selenic.com/wiki/KeyringExtension is for, but I haven't had time to integrate it properly (or instruct people in how to enable it themselves)_

* is it possible to have an easy way to change between projects.

_We should probably add File -> Recent Repositories, though in fact going through the Open dialog is less onerous than you might think_

* when you have uncommitted changes and push, the dialogue shou warn you that you are about to push even though you have uncommitted changes.

_True (this is also mentioned further up)_

* History Tab: the working revision black border is not explicit enough.

_OK... what shall we do about this one?_

* When working in a previous revision, the Update button is enabled; maybe it should read "Update to tip of branch" (some users found it confusing Updating to a revision and still having the Update button enabled)

_The status line tip for it does actually say something to this effect already.  Have to check whether the tooltip can be made to match, or whether it always follows the (limited space) text_

h2. General Comments

* Video on Merge command

* some questions we should answer in the documentation: 

** where should I put the local folder?

** is a Mercurial folder different from a normal working folder?

** advantages of local repo?? 

** how often should I commit? 

** how often should I push??

* Some confusion noticed over Redmine roles -- e.g. what's the point of Reporter? Can we document these better in add-user interface?

h2. People who had problems running the thing at all

* Maria, Andrew N -- similar but not identical PySomeSymbol missing errors from extension

* Mike -- some problem from extension, error not noted

* Xue -- stops responding (on windows) when clicking OK on settings dialog

h2. Other

* Xue tried: Commit; commit; update back to first commit; edit again -> easyhg asked for a merge, but it wasn't shown as requiring one at all in history

* Hiromasa points out that it doesn't display Shift-JIS filenames in Windows -- this is quite a serious one