Merge pull request #490 from wayofdev/feat/tpl-updates

Author: lotyp

.github/CODEOWNERS

@@ -0,0 +1,3 @@
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+* @lotyp

.github/ISSUE_TEMPLATE/1-bug-report.yml

@@ -1,8 +1,8 @@
 ---
 
-name: '🐞 Bug Report'
-description: 'Report an issue to help the project improve.'
-title: '[Bug] '
+name: 🐞 Bug Report
+description: Report an issue to help the project improve.
+title: '[Bug]: '
 labels: ['type: bug']
 
 assignees:
@@ -11,84 +11,91 @@ assignees:
 body:
   - type: markdown
     attributes:
-      value: '🐞 Bug Report'
+      value: 🐞 **Bug Report**
 
   - type: textarea
     id: bug-description
     attributes:
-      label: 'Describe the bug'
-      description: 'A clear and concise description of what the bug is.'
-      placeholder: 'Type here...'
+      label: Describe the bug
+      description: Please provide a clear and detailed description of what the bug is. This helps us understand the issue quickly and look for potential fixes.
+      placeholder: Explain the bug in as much detail as possible...
     validations:
       required: true
 
   - type: textarea
     id: regression
     attributes:
-      label: 'Is this a regression?'
+      label: Is this a regression?
       description: |
-        'Did this behaviour use to work in the previous version?
-        Yes, the last version in which this bug was not present was: ...'
-      placeholder: 'Yes or No and details...'
+        Was this functionality working in a previous version?
+        If yes, please mention the last version in which it worked properly.
+        Understanding regressions helps prioritize fixes.
+      placeholder: Yes or No, and details about the last working version...
     validations:
       required: false
 
   - type: textarea
     id: steps-to-reproduce
     attributes:
-      label: 'To Reproduce'
+      label: To Reproduce
       description: |
-        'Steps to reproduce the error:
+        'Please provide step-by-step instructions that reproduce the issue:
         1. Use x argument / navigate to...
         2. Fill this information...
         3. Go to...
-        4. See error'
-      placeholder: 'Describe the steps...'
+        4. See error
+      placeholder: Detailed steps to reproduce the bug...
     validations:
       required: true
 
   - type: textarea
     id: expected-behaviour
     attributes:
-      label: 'Expected behaviour'
-      description: 'A clear and concise description of what you expected to happen.'
-      placeholder: 'Type here...'
+      label: Expected behaviour
+      description: |
+        Describe what you expected to happen.
+        Clear expectations help understand the gap between current and desired states.
+      placeholder: What did you expect to happen instead of the bug?
     validations:
       required: true
 
   - type: textarea
     id: media
     attributes:
-      label: 'Media prove'
-      description: 'If applicable, add screenshots or videos to help explain your problem.'
-      placeholder: 'Upload files or leave a link here...'
+      label: Media prove
+      description: If applicable, add screenshots or videos to better illustrate the issue. Visual aids can significantly aid in diagnosing problems quicker.
+      placeholder: Upload files or paste links here...
     validations:
       required: false
 
   - type: textarea
     id: environment
     attributes:
-      label: 'Your environment'
+      label: Your environment
       description: |
-        'Please provide information about your environment.
+        Provide detailed information about your environment to help us replicate the issue:
         * OS: [e.g. Ubuntu]
         * PHP version: [e.g. 8.2.2]
         * Package version: [e.g. 1.0.0]
-      placeholder: 'Fill out all applicable fields...'
+        * Any relevant environment details
+      placeholder: List your environment details here...
     validations:
       required: false
 
   - type: textarea
     id: additional-context
     attributes:
-      label: 'Additional context'
-      description: 'Add any other context or additional information about the problem here.'
-      placeholder: 'Type here...'
+      label: Additional context
+      description: Include any other context about the problem here, such as unusual system configurations, previous issues, or possible causes.
+      placeholder: Any additional information that could help us resolve the issue...
     validations:
       required: false
 
   - type: markdown
     attributes:
       value: |
-        📛 To expedite issue processing, please search open and closed issues before submitting a new one.
-        Please read our Rules of Conduct at this repository's `.github/CODE_OF_CONDUCT.md` and the Contribution Guidelines at `.github/CONTRIBUTING.md` 📛
+        📛 To ensure a smooth issue processing, please check if a similar bug report has already been submitted before creating a new one.
+        We highly value your contributions, so please make sure to familiarize yourself with our repository's guidelines:
+        - [Code of Conduct](.github/CODE_OF_CONDUCT.md)
+        - [Contribution Guidelines](.github/CONTRIBUTING.md)
+        📛

.github/ISSUE_TEMPLATE/2-feature-request.yml

@@ -0,0 +1,71 @@
+---
+
+name: 🚀 Feature Request
+description: Suggest an idea or possible new feature for this project.
+title: '[Feature]: '
+labels: ['type: enhancement']
+
+assignees:
+  - lotyp
+
+body:
+  - type: markdown
+    attributes:
+      value: 🚀 **Feature Request**
+
+  - type: textarea
+    id: problem-related
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: |
+        Please provide a clear and detailed description of what the problem is.
+        For example, 'I'm always frustrated when...'.
+        This will help us understand the context and the impact of the problem.
+      placeholder: Describe the problem...
+    validations:
+      required: true
+
+  - type: textarea
+    id: desired-solution
+    attributes:
+      label: "Describe the solution you'd like"
+      description: |
+        What would you like to see happen? Please provide a detailed explanation of the desired feature.
+        You may include bullet points to outline objectives, key activities, and expected outcomes.
+      placeholder: |
+        1. Objective: [What you hope to achieve with this feature]
+        2. Key Activities: [Steps to implement the feature]
+        3. Expected Outcome: [Benefits and results of the feature]
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternative-solutions
+    attributes:
+      label: "Describe alternatives you've considered"
+      description: |
+        Are there alternative solutions or features you've considered? Please describe them.
+        Understanding different possible solutions can help in finding the best path forward.
+      placeholder: Describe any alternative solutions or workarounds you have considered...
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: |
+        Add any other context or screenshots about the feature request here.
+        Links to similar features, or visual aids that support your proposal, if applicable.
+      placeholder: Insert any additional context or links to similar features here...
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        📛 To ensure a smooth issue processing, please check if a similar feature request has already been submitted before creating a new one.
+        We highly value your contributions, so please make sure to familiarize yourself with our repository's guidelines:
+        - [Code of Conduct](.github/CODE_OF_CONDUCT.md)
+        - [Contribution Guidelines](.github/CONTRIBUTING.md)
+        📛

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+---
+
+blank_issues_enabled: true
+
+contact_links:
+  - name: Send an e-mail to the developer
+    url: mailto:the@wayof.dev
+    about: Please do NOT use this email to post issues or feature requests (only important business/personal contact).