From 40ac00d38c92af3d886039714af37cee01648602 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 28 Nov 2025 00:34:42 -0500 Subject: [PATCH 1/4] Initial version of issue template for the new Primer --- .github/ISSUE_TEMPLATE/primer.yml | 67 +++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/primer.yml diff --git a/.github/ISSUE_TEMPLATE/primer.yml b/.github/ISSUE_TEMPLATE/primer.yml new file mode 100644 index 00000000..d9daca57 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/primer.yml @@ -0,0 +1,67 @@ +name: Report an issue with the **Medley Interlisp for the Newcomer** primer +description: Use this template to report issues or make suggestions +title: Title of your issue +assignees: '' +labels: primer, documentation +body: + - type: dropdown + id: problemType + attributes: + label: "What type of issue are you reporting?" + options: + - Suggested improvement + - Incorrect explanation / code sample + - Confusing explanation + - Outdated information + - Broken link + - Typo / Grammar + validations: + required: true + - type: dropdown + id: location + attributes: + label: "Section of the primer where the issue occurs" + options: + - Introduction + - Medley online and Medley Local + - Understanding and Navigating the Interface + - Understanding Lisp Syntax + - Atoms, Functions and Lists + - Variable Bindings and Scope + - Iterators and Conditionals + - The File Browser + - Debugging + - Editing functions with SEdit + - Build Your First Interactive Program + - Saving Your Work + - TEdit, The WYSIWYG Editor + - Drawing and Displaystreams + - Making a Graph with Grapher + - Additional Resources + - General Feedback (not specific to a section) + validations: + required: true + - type: input + id: issueLocationDetails + attributes: + label: "Please provide more details about the location of the issue" + description: "For example, the specific page title, section heading, or code sample number." + validations: + required: false + - type: textarea + id: issueDescription + attributes: + label: "Description of the issue" + description: "Please provide a detailed description of the issue you encountered." + validations: + required: true + - type: textarea + id: suggestedFix + attributes: + label: "Suggested fix or improvement" + description: "If you have a suggestion for how to fix or improve the issue, please provide it here." + validations: + required: false + - type: markdown + attributes: + value: "## Thank you for helping us improve the **Medley Interlisp for the Newcomer** primer!" \ No newline at end of file From d30584cc2903b21e81fb76cadf75485dd69c48f8 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 28 Nov 2025 00:44:13 -0500 Subject: [PATCH 2/4] Fix syntax errors --- .github/ISSUE_TEMPLATE/primer.yml | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/primer.yml b/.github/ISSUE_TEMPLATE/primer.yml index d9daca57..8a15bfb8 100644 --- a/.github/ISSUE_TEMPLATE/primer.yml +++ b/.github/ISSUE_TEMPLATE/primer.yml @@ -1,8 +1,9 @@ name: Report an issue with the **Medley Interlisp for the Newcomer** primer description: Use this template to report issues or make suggestions title: Title of your issue -assignees: '' -labels: primer, documentation +labels: + - primer + - documentation body: - type: dropdown id: problemType @@ -15,8 +16,8 @@ body: - Outdated information - Broken link - Typo / Grammar - validations: - required: true + validations: + required: true - type: dropdown id: location attributes: @@ -39,8 +40,8 @@ body: - Making a Graph with Grapher - Additional Resources - General Feedback (not specific to a section) - validations: - required: true + validations: + required: true - type: input id: issueLocationDetails attributes: From fbe98dd044aa7123d084c4d0efdfac8880e60662 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 28 Nov 2025 00:46:21 -0500 Subject: [PATCH 3/4] Change additional information to textarea --- .github/ISSUE_TEMPLATE/primer.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/primer.yml b/.github/ISSUE_TEMPLATE/primer.yml index 8a15bfb8..3f33bfe3 100644 --- a/.github/ISSUE_TEMPLATE/primer.yml +++ b/.github/ISSUE_TEMPLATE/primer.yml @@ -42,7 +42,7 @@ body: - General Feedback (not specific to a section) validations: required: true - - type: input + - type: textarea id: issueLocationDetails attributes: label: "Please provide more details about the location of the issue" From 5bca03d81e7897737c3ec5ff88edffb0e35493e9 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 28 Nov 2025 08:28:12 -0500 Subject: [PATCH 4/4] Resolve review feedback. --- .github/ISSUE_TEMPLATE/primer.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/primer.yml b/.github/ISSUE_TEMPLATE/primer.yml index 3f33bfe3..016db1a8 100644 --- a/.github/ISSUE_TEMPLATE/primer.yml +++ b/.github/ISSUE_TEMPLATE/primer.yml @@ -1,5 +1,5 @@ name: Report an issue with the **Medley Interlisp for the Newcomer** primer -description: Use this template to report issues or make suggestions +description: Use this template to report issues or make suggestions. title: Title of your issue labels: - primer @@ -41,12 +41,12 @@ body: - Additional Resources - General Feedback (not specific to a section) validations: - required: true + required: true - type: textarea id: issueLocationDetails attributes: label: "Please provide more details about the location of the issue" - description: "For example, the specific page title, section heading, or code sample number." + description: "For example, the specific page title, section heading, or url." validations: required: false - type: textarea