chore(github): add issue forms for resources, link problems and roadmap changes

This commit is contained in:
Meysam Parvizi
2026-10-09 17:56:22 +02:00
parent 8ba3a7f235
commit 52aa4a7efa
4 changed files with 164 additions and 0 deletions
+5
View File
@@ -0,0 +1,5 @@
blank_issues_enabled: true
contact_links:
- name: Contributing guidelines
url: https://github.com/m3y54m/Embedded-Engineering-Roadmap/blob/master/CONTRIBUTING.md
about: Read these before suggesting a resource or opening a pull request.
@@ -0,0 +1,45 @@
name: Report a link problem
description: A link is broken, moved, mislabeled, off-topic or in the wrong section
title: "[Link] "
labels: ["link-problem"]
body:
- type: markdown
attributes:
value: |
Use this form for any problem with an existing entry. Select every problem that applies.
If you already know the fix, a pull request is welcome too.
- type: input
id: entry
attributes:
label: Entry
description: The title or URL of the entry, and the section it is in.
validations:
required: true
- type: dropdown
id: problems
attributes:
label: What is wrong?
multiple: true
options:
- Link is broken (404, domain gone, site down)
- Link moved to a new address
- Link opens something different from its title
- Content is outdated
- Content is not related to the section it is in
- Wrong type marker or quality marker (📘 🎞️ 📝 🔗 👶 💎)
- Site is unsafe, spammy or requires an unexpected paywall
- Duplicate of another entry
validations:
required: true
- type: textarea
id: details
attributes:
label: Details
description: What you saw, and when. Include the error message if there is one.
validations:
required: true
- type: textarea
id: fix
attributes:
label: Suggested fix (optional)
description: A replacement link, a better section, the correct marker, or "remove it".
@@ -0,0 +1,78 @@
name: Suggest a resource
description: Propose a book, video, article or tool to add to the roadmap
title: "[Resource] "
labels: ["resource"]
body:
- type: markdown
attributes:
value: |
Thanks for contributing! Please read the [contributing guidelines](https://github.com/m3y54m/Embedded-Engineering-Roadmap/blob/master/CONTRIBUTING.md) first.
Free resources are preferred, and each entry needs a clear reason to be there.
- type: input
id: url
attributes:
label: Link
placeholder: https://
validations:
required: true
- type: input
id: title
attributes:
label: Title and author
description: As it should appear in the list, for example "Title - Author".
validations:
required: true
- type: dropdown
id: type
attributes:
label: Resource type
options:
- "📘 Book"
- "🎞️ Video"
- "📝 Article or blog post"
- "🔗 Other (tool, documentation, website)"
- "🎧 Audio book"
validations:
required: true
- type: input
id: section
attributes:
label: Section it belongs to
description: Heading in the README where it fits best. If you are not sure, describe the topic.
placeholder: "Microcontrollers > Interrupts"
validations:
required: true
- type: dropdown
id: level
attributes:
label: Audience
options:
- Beginner-friendly (👶)
- Intermediate
- Advanced
- Well-known, comprehensive reference (💎)
multiple: true
validations:
required: true
- type: dropdown
id: cost
attributes:
label: Cost
options:
- Free
- Free with registration
- Paid
validations:
required: true
- type: textarea
id: why
attributes:
label: Why should it be included?
description: If it is paid, explain why it is clearly better than the free options already listed.
validations:
required: true
- type: input
id: replaces
attributes:
label: Replaces an existing entry (optional)
description: Name or link of the entry this would replace, if any.
@@ -0,0 +1,36 @@
name: Suggest a topic or structure change
description: Propose a new topic, a missing section, or a reorganization
title: "[Roadmap] "
labels: ["roadmap"]
body:
- type: markdown
attributes:
value: |
New topics should be useful to other learners and fit the roadmap's structure. See the "Roadmap Alignment" section of the [contributing guidelines](https://github.com/m3y54m/Embedded-Engineering-Roadmap/blob/master/CONTRIBUTING.md).
- type: dropdown
id: kind
attributes:
label: What do you suggest?
multiple: true
options:
- Add a new topic or section
- Move or reorganize existing sections
- Change the roadmap diagram
- Improve the introduction or explanations
- Other
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposal
description: Describe the change and where it would go.
validations:
required: true
- type: textarea
id: why
attributes:
label: Why does it help learners?
description: Which skill or job role it covers, and why it is missing today.
validations:
required: true