About READMEs for enterprises
To help people understand what is happening in your enterprise, you should create a README. For example, you can use a README to help members learn about different organizations in the enterprise, to share links to important resources, or to communicate information about the settings and policies of your enterprise.
The README is displayed on the enterprise's "Overview" page, which is the page you see when you navigate to the enterprise at github.com/enterprises/YOUR-ENTERPRISE
. This page is only visible to members of the enterprise.
You can also create READMEs for organizations in your enterprise, visible either publicly or only to members. For more information, see "Customizing your organization's profile."
Creating a README for an enterprise
-
In the top-right corner of GitHub, click your profile photo, then click Your enterprises.
-
In the list of enterprises, click the enterprise you want to view.
-
On the "Overview" page, click Create README. If a README is already present on the page, click Edit.
-
Write the content for your README. You can use Markdown to format the content, such as adding headings, images, and lists. For more information, see "Basic writing and formatting syntax."
Note
You can only link to publicly hosted images in your README. You cannot upload an image to your README, or link to an image from a private repository.
-
Click Save.