diff --git a/README.md b/README.md index f5730b788246..84446dc5911c 100644 --- a/README.md +++ b/README.md @@ -11,13 +11,13 @@ Welcome to GitHub Docs! GitHub’s documentation is open source, meaning anyone ## How we sync changes across Docs repositories -There are two GitHub Docs repositories: +There are two GitHub Docs repositories: - **`github/docs`** (public): Open to external contributions - **`github/docs-internal`** (private): For GitHub employee contributions. -The two repositories sync frequently. Content changes in one are reflected in the other. Hubbers might prefer to post in `docs` when working with a customer, but `docs` has limitations on the types of contributions it accepts to safeguard the site and our workflows. Internal contributions should usually go to `docs-internal`. +The two repositories sync frequently, so content changes in one are reflected in the other. Hubbers might prefer to post in `docs` when working with a customer, but `docs` has limitations on the types of contributions it accepts to safeguard the site and our workflows. Internal contributions should usually go to `docs-internal`. **Important:** The `docs` repository accepts contributions to content files (`.md` files in `/content` and select `/data` sections like reusables only). Infrastructure files, workflows, and site-building code are not open for external modification.