Skip to content

Latest commit

 

History

History
51 lines (26 loc) · 4.27 KB

org-presence-on-github.md

File metadata and controls

51 lines (26 loc) · 4.27 KB

Maximizing organization's public presence on GitHub

Creating and customizing open source organizations on GitHub

Organization creation

If you already have an organization account, you can skip this section. You should make sure that you are signed in to GitHub and then navigate to https://github.com/organizations/plan.

Set up organization

Take your time to read through the different options and prices for different types of organization accounts. For the purposes of this guide, we will just stick to a free organization account. Now select your organization name which should match the name of the legal entity it represents if possible.

Ownership of the organization is important to note here. Does this organization belong to you personally or to a company or entity other than yourself? Select the proper ownership here. Also, consider creating a shared inbox for your open source group (ie. opensource@myorganization.com) so that if the person who’s email you enter gets promoted, the organization is able to retain access.

Organization profile page

Navigate to https://github.com/<ORG_NAME>. Here is an example of what a profile page starts out looking like.

New profile example

One goal of the open source programs office is to get their profile completed so that people can tell that this is an active and trustworthy organization. See the difference between a new profile and a completed one below.

Completed profile example

While you are logged in, navigate to https://github.com/organizations/<ORG_NAME>/settings/profile. This is where you can begin to complete the profile details.

For your profile details, make sure they professionally and accurately reflect the business that owns the account. We recommend using a company logo or monogram as the profile picture as well.

Organization verification

It is important to verify your organization as it provides a means of trust (authenticity) that your organization is who it says it is. To do this navigate to https://github.com/organizations/<ORG_NAME>/settings/domains and verify your organization.

Organization README

Creating an organization README is an important step in completing your organization's profile. This is your chance to introduce your organization and show who you are beyond a name and logo.

Create a public repository called .github. Once created, add a /profile/README.md file. The README will appear on your organization's profile, visible to anyone. You can check out the documentation at https://docs.github.com/en/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile .

Pinned repositories

Pinned repositories are a way to highlight up to 6 repositories from your organization. Perhaps these are your top Open Source projects or repositories that you would like to gain more traction. Either way, these repositories will stand out at the top of your organization's page as a featured set. This contributes to the impression that your organization has a complete profile and active work going on.

Collaborating with other teams in your organization

Does your organization have a team that manages public relations and branding? If so, it's a good idea to work with them to ensure that the organization’s profile that you are creating on GitHub is approved or co-authored by these groups.

Next steps

Now that you have an organization on GitHub, consider what steps members of your organization should take in order to have a repo appear publicly on the organization's page. Check out the resources over at the TODO group for starting an open source project and opensource.guide as well.

Open source projects often lead to communities being built around the code. Maintaining open source projects and their communities takes work and should be planned for. We’ve got an entire guide dedicated to building community.