Skip to content

Commit 9ee8811

Browse files
Improve tutorial-update-monitor deduplication: topic-based search to prevent duplicate issues
Agent-Logs-Url: https://github.com/instil/github-copilot-tutorial/sessions/18216a9f-ae40-4c05-b419-3f6406ea36e5 Co-authored-by: calebwilson706 <71669491+calebwilson706@users.noreply.github.com>
1 parent ed4b371 commit 9ee8811

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

.github/workflows/tutorial-update-monitor.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -63,16 +63,21 @@ Use the GitHub tool to list recent commits (last 14 days) from `github/copilot-c
6363

6464
3. **Check `github/copilot-cli-for-beginners`** for commits from the past 14 days using the GitHub tool.
6565

66-
4. **Search for existing issues** in `instil/github-copilot-tutorial` to avoid creating duplicates. Search for **both open and closed** issues with titles containing "Tutorial update needed". Also look for issues labelled `not planned` or in a closed/not-planned state. If a similar issue already exists in any state, skip creating a new one.
67-
68-
5. **For each meaningful finding**, create a GitHub issue in `instil/github-copilot-tutorial`:
66+
4. **Before creating any issue**, perform a thorough duplicate check in `instil/github-copilot-tutorial`:
67+
- Search **all issues (open AND closed)** with the label `tutorial-update`
68+
- For each finding, extract the **key subject** (e.g. the command name like `/pr`, the feature name like `extensions`, the config key like `--effort`)
69+
- Search for that key subject as a keyword in existing issues — not just the title prefix. For example, if a finding is about the `/pr` command, search for `/pr` in existing issue titles and bodies
70+
- **If any existing issue — open, closed, or not-planned — already covers the same command, feature, or tutorial gap, skip creating a new issue entirely**
71+
- Two issues cover the same gap if they refer to the same command, flag, config option, or tutorial lesson area — even if the wording, framing, or source reference differs
72+
73+
5. **For each meaningful finding with no pre-existing issue**, create a GitHub issue in `instil/github-copilot-tutorial`:
6974
- **Title**: `Tutorial update needed: [short description of what changed]`
7075
- **Body** must include:
7176
- A clear summary of what changed and why the tutorial needs updating
7277
- A direct link to the relevant release, documentation section, or commit
7378
- The specific part(s) of the tutorial that need updating
7479
- Suggested changes or new content to add
75-
- Skip creating an issue if a similar one already exists in any state (open, closed, or not planned — based on the check in step 4)
80+
- Do **not** create an issue if a similar one already covers this topic in any state
7681

7782
## Guidelines
7883

@@ -81,3 +86,4 @@ Use the GitHub tool to list recent commits (last 14 days) from `github/copilot-c
8186
- Group closely related changes into a single issue when it makes sense.
8287
- Be specific and actionable in issue descriptions so maintainers can address them quickly.
8388
- Limit to **5 issues per run** to avoid noise.
89+
- **Prefer no new issue over a possible duplicate.** When the topic of a finding is already covered by any existing issue — even if it approaches it from a different angle — skip creating a new issue. It is better to miss a subtle nuance than to create a duplicate that adds noise for maintainers.

0 commit comments

Comments
 (0)