Case-conflict between canonical repo address and go imports

[liggitt]

The github.com/Microsoft org was just renamed to github.com/microsoft

This means that the canonical github repo address now conflicts with canonical go import packages (for example, "github.com/Microsoft/hcsshim/internal/hcserror", as referenced from https://github.com/microsoft/hcsshim/blob/master/hcsshim.go#L9)

It is now very easy for downstream consumers that depend on leaf packages only (which don't import any other upper-case "github.com/Microsoft/..." packages) to accidentally clone and add imports to lower-case "github.com/microsoft/..." packages. This will work in isolation, but as soon as their library has to coexist in a build with any other component which used the canonical "github.com/Microsoft/..." imports, builds will start failing.

(This was possible before, but way harder to do accidentally, since all the links and clone commands from github agreed with the canonical go import packages)

Context:

• https://twitter.com/ehotinger/status/1125792922463424512
• https://twitter.com/liggitt/status/1125843936864612353

Cautionary tale:

• Rename back to Sirupsen/logrus sirupsen/logrus#570 (comment)

Also filed in the other Microsoft dependency we use in Kubernetes:
microsoft/go-winio#135

Please consider reverting the Microsoft -> microsoft rename.

cc @jeffwilcox

[liggitt]

(hoisting from https://twitter.com/liggitt/status/1125879048658403329 so it doesn't get lost)

If the case change is here to stay, some things that would help a lot:

1. guidance and checks to ensure all the go repos under the org agree and continue to use Microsoft
2. example go get commands in the READMEs of all the go repos to guide consumers
3. add canonical import paths with the correct upper case (https://golang.org/doc/go1.4#canonicalimports) to prevent accidental use of the wrong case downstream

[jstarks]

Thanks Jordan. These are good suggestions. We are discussing internally what we want to do across Microsoft's go repos so that we can have a consistent approach.