Skip to content

Commit 93618fa

Browse files
committed
Updates and added Issue templates
1 parent a37598d commit 93618fa

File tree

5 files changed

+33
-9
lines changed

5 files changed

+33
-9
lines changed

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,9 @@ Check out some [Awesome README examples](https://github.com/matiassingers/awesom
6969

7070
Once the project launches, use email and other networking channels to promote it. Reaching an appropriate audience could produce a significant boost in project participation.
7171

72+
[Learn more about README files in the GitHub documentation.](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)
73+
74+
7275
### Manage projects on GitHub
7376

7477
As projects gain traction, the influx of users and contributions can require lots of work to manage. Depending on the project, a significant amount of work might be required just to manage the expectations of project participants.

learn-pr/github/manage-work-github-projects/includes/3-how-to-create-project.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ In this unit, you learn how to:
88
- Set the name, description, and README of your Project.
99
- Add issues and pull requests to your Project.
1010

11-
## Creating an organization-level Project
11+
## Creating an organization-owned Project
1212

1313
First, you want to lay the foundation by creating a new Project. Creating is relatively quick and simple.
1414

@@ -26,7 +26,10 @@ First, you want to lay the foundation by creating a new Project. Creating is rel
2626

2727
You just created a Project!
2828

29-
You can also create a personal Project by selecting your profile photo and navigating to **Your projects**. Once you're on your Projects page, select the green button titled **New project**.
29+
> [!TIP]
30+
> You can also create a personal Project by selecting your profile photo and navigating to **Your projects**, then clicking **New project**.
31+
> Additionally, Projects can be created directly from a repository—this links the repository to the Project automatically, though the Project itself is still created at the organization level and can be linked to other repositories or projects in the future.
32+
3033

3134
## Set your Project's name, description, and README
3235

learn-pr/github/manage-work-github-projects/includes/5-how-to-organize-automate-project.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,18 +27,18 @@ To change your Project's visibility:
2727

2828
### Manage access to your Project
2929

30-
Access to your Project depends on if your Project is an organization-level Project or a personal/user-level Project. Managing access is similar between the two levels.
30+
Access to your Project depends on if your Project is an organization-owned Project or a personal/user-owned Project. Managing access is similar between the two levels.
3131

32-
Admins of organization-level Projects can manage access for the entire organization, for teams, for individual organization members, and for outside collaborators. Admins of user-level Projects can invite individual collaborators and manage their access.
32+
Admins of organization-owned Projects can manage access for the entire organization, for teams, for individual organization members, and for outside collaborators. Admins of user-owned Projects can invite individual collaborators and manage their access.
3333

34-
#### Organization-level Project
34+
#### Organization-owned Project
3535

3636
- **No access**: Only organization owners and users granted individual access can see the Project. Organization owners are also admins for the Project.
3737
- **Read**: Everyone in the organization can see the Project. Organization owners are also admins for the Project.
3838
- **Write**: Everyone in the organization can see and edit the Project. Organization owners are also admins for the Project.
3939
- **Admin**: Everyone in the organization is an admin for the Project.
4040

41-
#### Personal/User-level Project
41+
#### Personal/User-owned Project
4242

4343
- **Read**: The individual can view the Project.
4444
- **Write**: The individual can view and edit the Project.

learn-pr/github/manage-work-github-projects/includes/8-summary.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ You learned how to:
44

55
- Build an organization Project
66
- Automate and organize your Project
7-
- Compare Projects vs Projects (Classic)
87
- Use layout options like boards, tables, and timelines
98
- Enable default workflows to automate project tasks
109
- Convert checklist items into sub-issues for better tracking

learn-pr/github/search-organize-repository-history-github/includes/2-search-organize-repository-history-github.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,11 @@ Learn more about [Understanding the search syntax](https://docs.github.com/enter
5252

5353
## Using Milestones
5454

55-
Milestones let you group issues and pull requests into shared goals, like a sprint, a product release, or a project phase.
55+
Milestones let you group issues and pull requests into shared goals, like a sprint, a product release, or a project phase. They help teams track progress and keep everyone aligned.
56+
57+
- Milestones can be ordered (just like projects), making it easy to set priorities and visualize which milestones are most important.
58+
- Progress towards each milestone is tracked automatically—GitHub shows how many issues or PRs are complete and how many remain.
59+
- Milestones are especially useful for tracking work that goes into separate releases or phases.
5660

5761
### Create a milestone
5862

@@ -68,7 +72,7 @@ Milestones let you group issues and pull requests into shared goals, like a spri
6872
2. In the right sidebar, select Milestone.
6973
3. Choose from the list of available milestones.
7074

71-
When you view a milestone, GitHub shows how many issues/PRs are complete and how many remain—making it a helpful planning and tracking tool.
75+
You can also add milestones as a column to your GitHub Projects layout or display a milestone as a card on a GitHub Projects board. This helps visualize and manage your team’s progress directly from your project planning board.
7276

7377
> You can filter by milestone in GitHub Projects or with advanced search queries like:
7478
>
@@ -156,6 +160,21 @@ When writing a comment on an issue or pull request, you can insert a saved reply
156160
157161
Saved replies save time and help ensure consistency when responding across your project.
158162
163+
Here’s an updated version that includes guidance on **issue templates**—explaining what they are, how they differ from saved replies, and why they’re usually better for collecting structured information up front.
164+
165+
## Issue Templates
166+
167+
While saved replies are useful for common responses, **issue templates** are a better way to make sure contributors provide all the necessary information when creating new issues.
168+
169+
* **Issue templates** prompt users to fill in specific fields or answer certain questions up front, reducing back-and-forth and ensuring you have the details you need from the start.
170+
* Templates help maintainers avoid “lost data” by collecting structured information before an issue is even submitted.
171+
172+
**Tip:**
173+
To set up issue templates, go to your repository’s **Settings** > **Issues** > **Set up templates**. You can create templates for bug reports, feature requests, or anything else your project needs.
174+
175+
> **Best practice:**
176+
> Use issue templates to capture required details and reduce missing or incomplete information. Use saved replies for routine responses and instructions after issues or pull requests are submitted.
177+
159178
## Adding assignees
160179
161180
You can assign one or more people to an issue or pull request to show who’s responsible for working on it.

0 commit comments

Comments
 (0)