improved source code clone instructions

ID	Created	Type	mocl Version	Dev OS	Target	Status
#32	by masukomi on 2013-11-26 (1423 days ago)	enhancement	n/a	n/a	n/a	closed

Description

Summary: current source code clone instructions on support home lack important details

Currently the source clone instructions tell you the git clone url and instruction you to use your email address as the username. 

Problem: 

1) fails to mention you need to include your password
2) many developers are unfamiliar with the username:password@domain syntax in urls
3) even more are unaware of how to handle @ symbols in usernames and passwords.

Expected result:

Improved instructions will give an appropriately encoded url (without the password) 

e.g. 

Git clone URL: https://my-email%40example.com:<your password here>@example.com/foo/bar/mocl.git

Please replace <your password here> with your password.

Comments

Hi,

Sorry for the confusion! The instructions were based on the idea that the ordinary git client will prompt for a username and password as needed. Did this not happen in your case?

Wes

- Wukix, 1423 days ago

FYI I just added a 'Show Example' button that hopefully clarifies.

- Wukix, 1423 days ago

It did not happen in my case because I knew about username and password encoding in urls, took the instructions as implying that it was desired, and then took the steps to encode the username and password in the url, thus removing the need for anything to ask for it. I wasn't aware that git would handle HTTP BASIC auth automatically if the username and password weren't supplied. 

I think the new "Show Example" is a better solution to this documentation problem than my proposed one. :)

- masukomi, 1422 days ago