Start documentation on build

CONTRIBUTING.md

@@ -10,6 +10,21 @@ using [Azure/autorest.go][] and [Azure/autorest][]. These generated packages dep
 
 For bugs or feature requests you can submit them using the [Github issues page][issues] and filling the appropriate template.
 
+## Building
+
+SDKs are either "track 1" or "track 2":
+
+- Track 1 SDKs are found in the services/ and profiles/ top level folders. 
+    - CI is in \azure-pipelines.yml
+- Track 2 SDK are foudn in the sdk/ top level folder.
+    - CI is in \eng\pipelines\templates\steps\build.yml
+
+To build, run `go build` from the respective SDK directory.
+
+There currently is not a repository wide way to build or regenerate code.
+
+## Guidelines and Code of Conduct
+
 Also please see these [guidelines][] about contributing to Azure projects.
 
 This project follows the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][cocfaq]. Contact [[email protected]][cocmail] with questions and comments.

README.md

@@ -38,9 +38,6 @@ APIs are updated frequently, we release a **new major version at the end of
 each month** with a full changelog. For more details and background see [SDK Update
 Practices](https://github.com/Azure/azure-sdk-for-go/wiki/SDK-Update-Practices).
 
-To more reliably manage dependencies like the Azure SDK in your applications we
-recommend [golang/dep](https://github.com/golang/dep).
-
 Packages that are still in public preview can be found under the ./services/preview
 directory. Please be aware that since these packages are in preview they are subject
 to change, including breaking changes outside of a major semver bump.

azure-pipelines.yml

@@ -1,3 +1,5 @@
+# This builds only track 1 SDKs. See eng\pipelines\templates\steps\build.yml for track 2.
+
 trigger:
   paths:
     exclude:

eng/pipelines/templates/steps/build.yml

@@ -1,3 +1,5 @@
+# This builds only track 2 SDKs. See \azure-pipelines.yml for track 1.
+
 parameters:
   ServiceDirectory: ''
   GoWorkspace: ''