# Microsoft Team Onboarding

If you are new to Microsoft, you will need to onboard into various GitHub projects in order to get your work done.

## Set up Your Account

1. **Link** your GitHub account to your Microsoft login
    * Follow steps on https://repos.opensource.microsoft.com/link
    * Note: This will add you as a member into [Microsoft organization](https://github.com/orgs/Microsoft/people)
2. Publicly associate yourself with **Microsoft organization**
    * Go to https://github.com/orgs/Microsoft/people
    * Search for your GH login in the list
    * Choose `Public` from the drop-down list of organization visibility
    * Note: Everyone will now see a Microsoft badge on your GH profile in Organizations section on the left side
3. Join **dotnet organization**
    * Go to https://repos.opensource.microsoft.com
		* Select `DotNet` on the right side and click `Join`
4. Publicly associate yourself with **dotnet organization**
    * Go to https://github.com/orgs/dotnet/people
    * Search for your GH login in the list
    * Choose `Public` from the drop-down list of organization visibility
    * Note: Everyone will now see a dotnet badge on your GH profile in Organizations section on the left side
5. Update your profile
    * Go to https://github.com/settings/profile
    * Match your **Name** on GitHub with full name in address book (so other employees can find you and contact you internally when needed)
    * Set `@Microsoft` as your **Company**
    * Upload your **picture**, ideally showing your face
        * Hint: You can grab your GAL picture from https://microsoft-my.sharepoint.com
6. **Join GitHub teams** to gain read-write access to repos
    * Request team membership via https://repos.opensource.microsoft.com/teams
    * Find the right teams - e.g. `dotnet-coreclr`, `dotnet-corefx`, etc.
    * Select `Request to join this team` on the right side - it will send email request to maintainers of the team


## Service Accounts

Service accounts should also be linked. For more details, see [Service accounts for GitHub](https://docs.opensource.microsoft.com/github/service-accounts.html).


## Guidelines

* [Contributing to .NET Core](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/contributing.md)
* [What you can expect from Maintainers](https://github.com/dotnet/core/blob/master/Documentation/contributing/maintainers.md)


## Tools

* [Corporate GitHub Chrome Extension](https://repos.opensource.microsoft.com/settings/security/tokens/extension)
* [CodeFlow Chrome Extension](https://chrome.google.com/webstore/detail/codeflow/aphnoipocoffpdafmiidfmaiadhilelm)


## Resources

* [.NET Core "Home Repo"](https://github.com/dotnet/core) (links to install daily builds)
* [Introduction to the Common Language Runtime (CLR)](https://github.com/dotnet/coreclr/blob/master/Documentation/botr/intro-to-clr.md)
* [The Book of the Runtime](https://github.com/dotnet/coreclr/blob/master/Documentation/botr/README.md)
* [CoreCLR Docs](https://github.com/dotnet/coreclr/tree/master/Documentation)