[DEP] documentation for http basic authentication method for repositories

Depends on https://github.com/composer/composer/pull/1862

attempt to implement https://github.com/composer/composer/issues/1007