Skip to content

Latest commit

 

History

History
62 lines (38 loc) · 3.07 KB

best-practices-for-enterprises.md

File metadata and controls

62 lines (38 loc) · 3.07 KB
title shortTitle intro versions type topics
Best practices for enterprises
Best practices
Learn {% data variables.product.company_short %}-recommended practices for your enterprise.
ghec ghes
*
*
overview
Accounts
Enterprise
Fundamentals

{% ifversion ghec %}

Choose an enterprise type

Before you start using {% data variables.product.product_name %}, you must choose a type of enterprise. {% data reusables.enterprise.ghec-authentication-options %}

For help identifying the type of enterprise that will best meet your needs, see AUTOTITLE.

{% endif %}

Assign multiple owners

{% data reusables.organizations.ent-ownership-recommendation %} {% ifversion ghec or ghes %}For more information, see AUTOTITLE.{% endif %}

Use policies

We recommend using policies to enforce business rules and regulatory compliance.

{% data reusables.enterprise.about-policies %} For more information, see AUTOTITLE.

Minimize the number of organizations

Most businesses are best served by a single organization. Some enterprises may need multiple organizations for compliance or security reasons, but try to create as few as possible. A smaller number of organizations encourages innersource practice, allows discussions to involve a wider audience, and reduces administrative overhead.

For more guidance on how many organizations to create and how to structure them, see AUTOTITLE.

Avoid extensive collaboration in user-owned repositories

We recommend collaborating in organization-owned repositories whenever possible and minimizing collaboration in user-owned repositories. Organization-owned repositories have more sophisticated security and administrative features, and they remain accessible even as enterprise membership changes.

Use human-readable usernames

{% ifversion ghec %}If you control the usernames for enterprise members, use{% else %}Use{% endif %} human-readable usernames, and avoid machine-generated IDs that are difficult for humans to read.

You can manage the display of usernames within your enterprise's private repositories. For more information, see AUTOTITLE.

{% ifversion enterprise-readme %}

Create a README

{% data reusables.enterprise.about-readmes %} For more information, see AUTOTITLE.

{% endif %}

Further reading