Refine descriptions and enhance clarity in InnerSource program documentation

Author: Randy Pagels

learn-pr/github/manage-innersource-program-github/2-manage-innersource-program.yml

@@ -3,7 +3,7 @@ uid: learn.github.manage-innersource-program-github.2-manage-innersource-program
 title: How to manage a successful InnerSource program
 metadata:
   title: How to manage a successful InnerSource program
-  description: Learn to manage a successful InnerSource program on GitHub through effective discoverability, guidance, and maintenance.
+  description: Learn to manage a successful InnerSource program on GitHub through discoverability, guidance, repository setup, and collaboration best practices.
   ms.date: 09/19/2024
   author: a-a-ron
   ms.author: aastewar

learn-pr/github/manage-innersource-program-github/3-innersource-fundamentals.yml

@@ -3,7 +3,7 @@ uid: learn.github.manage-innersource-program-github.3-innersource-fundamentals
 title:  Exercise - InnerSource fundamentals
 metadata:
   title:  Exercise - InnerSource fundamentals
-  description: Learn to manage a successful InnerSource program on GitHub through effective discoverability, guidance, and maintenance.
+  description: Use checklists to evaluate your InnerSource readiness and improve your GitHub repositories through practical repository and team-based actions.
   ms.date: 09/19/2024
   author: a-a-ron
   ms.author: aastewar

learn-pr/github/manage-innersource-program-github/5-summary.yml

@@ -3,7 +3,7 @@ uid: learn.github.manage-innersource-program-github.5-summary
 title: Summary
 metadata:
   title: Summary
-  description: Review what you learned about InnerSource programs.
+  description: Review key practices for managing an InnerSource program using GitHub, including transparency, repository management, and collaboration.
   ms.date: 09/19/2024
   author: a-a-ron
   ms.author: aastewar

learn-pr/github/manage-innersource-program-github/includes/2-manage-innersource-program.md

@@ -10,12 +10,14 @@ Anyone can freely use, modify, and share open-source software. Using open-source
 
 An InnerSource program can offer numerous benefits beyond what traditional closed-source models provide.
 
-First, they *encourage transparency*. Access to the source code of other company projects can help developers be more productive when working on their own projects. They can see how different teams solve problems similar to the ones they're facing, and often find code and other assets that they can reuse. Access to team issues, pull requests, and project plans also provide better data for them to understand the velocity and direction of the project.
+First, they *support internal visibility*. Access to the source code of other company projects can help developers be more productive when working on their own projects. They can see how different teams solve problems similar to the ones they're facing, and often find code and other assets that they can reuse. Access to team issues, pull requests, and project plans also provide better data for them to understand the velocity and direction of the project.
 
-Next, they *reduce friction*. Let's say that a consumer team is dependent on a bug fix or new feature for a project owned by a different team. IN an InnerSource program, they have a channel through which they can propose the changes they need. And if those changes can't be merged in for any reason, the consumer team has the option of forking the project to meet their needs.
+Next, they *reduce friction*. Let's say that a consumer team is dependent on a bug fix or new feature for a project owned by a different team. In an InnerSource program, they have a channel through which they can propose the changes they need. And if those changes can't be merged in for any reason, the consumer team has the option of forking the project to meet their needs.
 
 Finally, they *standardize practices*. A common challenge development organizations face is that different teams often diverge in the ways they operate. Building an InnerSource program is a great opportunity to adopt standard conventions that can be used across every development team, even if they don't follow identical practices. For example, two teams might prefer different processes for accepting contributions. Having them standardize on the way they communicate their different processes makes it much easier for anyone to contribute to either.
 
+**Tip:** Consider using GitHub Discussions and GitHub Projects to further support InnerSource collaboration across teams.
+
 These examples are just a few of the benefits enjoyed by InnerSource programs. To learn more, see [An introduction to InnerSource](https://resources.github.com/whitepapers/introduction-to-innersource/?azure-portal=true).
 
 ## Set up an InnerSource program on GitHub

learn-pr/github/manage-innersource-program-github/includes/3-innersource-fundamentals.md

@@ -7,7 +7,14 @@ The following guide provides you with a getting started and expanded checklist o
 - Project
 - Developers
 
-Using the provided checklists, pick one of these categories and compare the list of items to one of your existing repositories. If you're focusing on the repository itself, what files do you need to add or remove to add clarity around its purpose? How do you contribute to the repository or open up issues?
+Using the provided checklists, choose one category and compare it to one of your current repositories. For example, if you're focusing on the repository itself, which files should be added or removed to clarify its purpose and contribution process?**
+
+**Example checklist – Repository:**
+- [ ] Add or update `README.md`
+- [ ] Include `LICENSE`
+- [ ] Provide a clear contribution guide (`CONTRIBUTING.md`)
+- [ ] Set repository visibility (public/internal/private)
+- [ ] Include issue and pull request templates
 
 After reading through the guide and identifying ways to improve your own GitHub repositories, return here for:
 

learn-pr/github/manage-innersource-program-github/includes/5-summary.md

@@ -1,16 +1,18 @@
-In this module, you learned how to manage a successful InnerSource program on GitHub through effective discoverability, guidance, and maintenance.
+In this module, you explored how to build and manage a successful InnerSource program on GitHub through effective discoverability, guidance, and maintenance.
 
-You learned about:
+This module covered:
 
 - Contrasting user owned projects versus organization owned projects.
 - Making recommendations about the number of GitHub organizations you should have.
 - Creating discoverable repositories.
 - Creating robust repository READMEs.
-- Using templates for issue requests and pull requests.
+- Using templates for issues and pull requests.
 - Building transparency into repositories.
 - Measuring the success of InnerSource within your organization.
 - Distributing your InnerSource toolkit.
 
+Apply these practices to your team projects to strengthen your InnerSource approach.
+
 Now that you have an InnerSource program together, learn to [Create an open-source program by using GitHub best practices](/training/modules/create-open-source-program-github/?azure-portal=true).
 
 ## Learn more