From 4f53ff7243dbc9505fb43cc200c8f2fdd71766ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C5=A1per=20Oblak?= Date: Tue, 26 Nov 2024 14:42:40 +0100 Subject: [PATCH] docs: adding github issue templates and updating readme (#345) --- .github/ISSUE_TEMPLATE/bug.yml | 130 +++++++++++++++++++++ .github/ISSUE_TEMPLATE/feature_request.yml | 61 ++++++++++ README.md | 1 + 3 files changed, 192 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug.yml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml new file mode 100644 index 0000000..e4755af --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -0,0 +1,130 @@ +name: Bug Report +description: Report a bug or issue with netbox-ssot +title: "[Bug] " +labels: ["Bug"] +body: + - type: markdown + attributes: + value: | + Thank you for reporting a bug! ๐Ÿ™ Please take a few moments to fill out the details below. + + โš ๏ธ **Important Notes**: + - Issues missing critical details may be closed without explanation. + - Be sure to provide the requested **configuration**, **logs**, and other details. This helps us diagnose and resolve your issue faster. + + - type: dropdown + id: urgent + attributes: + label: Is this urgent? + description: Is this issue blocking critical functionality? + options: + - "No" + - "Yes, it's critical" + - "Yes, but it's not blocking" + validations: + required: true + + - type: dropdown + id: method-of-running + attributes: + label: How are you running netbox-ssot? + description: Select the method you are using to run netbox-ssot. + options: + - Docker + - Podman + - Kubernetes (K8s) + - From source (Go) + - Other + validations: + required: true + + - type: dropdown + id: module-problem + attributes: + label: Which module has the issue? + description: Indicate the module where the issue occurs. + options: + - General (not module-specific) + - Parser + - Inventory + - Ovirt + - VMware + - DNAC + - Proxmox + - Palo Alto + - Fortigate + - FMC + - IOS-XE + - Other + validations: + required: true + + - type: input + id: version + attributes: + label: What version of netbox-ssot are you using? + placeholder: "e.g., 1.5.0" + description: Provide the exact version for better diagnostics. + validations: + required: true + + - type: textarea + id: config + attributes: + label: Share your configuration + description: Provide your `configuration.yml` (excluding sensitive information) used with netbox-ssot. + render: yaml + validations: + required: true + + - type: textarea + id: problem + attributes: + label: What is the problem? + placeholder: "Describe the issue you are experiencing." + description: Include as much detail as possible about the bug. + validations: + required: true + + - type: textarea + id: steps + attributes: + label: Steps to reproduce + description: | + Outline the exact steps needed to reproduce the issue, e.g.: + 1. Go to '...' + 2. Run '...' + 3. Observe the error. + placeholder: "1. Step one...\n2. Step two...\n3. Error occurs..." + validations: + required: true + + - type: textarea + id: expected + attributes: + label: What did you expect to happen? + placeholder: "e.g., The feature should work as described in the documentation." + validations: + required: true + + - type: textarea + id: actual + attributes: + label: What actually happened? + placeholder: "e.g., Instead of the expected behavior, the following error occurred..." + validations: + required: true + + - type: textarea + id: logs + attributes: + label: Share DEBUG-level logs (remove sensitive information) + description: Attach DEBUG-level logs for the session when the issue occurred. Make sure to redact sensitive data. + render: plaintext + + - type: textarea + id: environment + attributes: + label: Share your environment details + description: Include additional information about your environment, such as OS, architecture, or dependencies. + placeholder: "e.g., Ubuntu 22.04, x86_64, Docker 20.10.8" diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..05357b3 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,61 @@ +name: Feature Request +description: Suggest a new feature or enhancement for Netbox-ssot +title: "[Feature Request] <title>" +labels: ["Feature Request"] +body: + - type: markdown + attributes: + value: | + Thank you for suggesting a feature! ๐ŸŽ‰ Your input helps us improve Netbox-ssot. + + Please provide as much detail as possible to help us understand your idea and its use case. + + - type: textarea + id: description + attributes: + label: What is the feature? + description: | + Provide a clear and concise description of the feature you'd like to see. Include details about what it does and why it's needed. + placeholder: "I would like Netbox-ssot to have the ability to..." + validations: + required: true + + - type: textarea + id: use-case + attributes: + label: Why is this feature important? + description: | + Explain the problem this feature would solve or the benefits it would provide. Include specific scenarios where this feature would be useful. + placeholder: "This feature would help me by..." + validations: + required: true + + - type: textarea + id: implementation-ideas + attributes: + label: How could this feature be implemented? + description: | + Share your ideas for how this feature might work or be implemented. If you're unsure, feel free to leave this blank. + placeholder: | + - This feature could be added as a configuration option... + - A similar tool does it this way... + render: plaintext + + - type: textarea + id: alternatives + attributes: + label: Have you considered alternatives? + description: | + List any alternative solutions or workarounds you've tried or thought about. + placeholder: "Instead of this feature, I tried..." + render: plaintext + + - type: textarea + id: extra + attributes: + label: Additional context or references + description: | + Provide links, screenshots, or other references that help illustrate your feature request. + placeholder: | + - Hereโ€™s an example of the desired behavior: [link](https://example.com) + - Screenshot of the issue: ![screenshot](url) diff --git a/README.md b/README.md index 071e27d..67d6c39 100644 --- a/README.md +++ b/README.md @@ -197,6 +197,7 @@ source: hostname: 10.10.1.1 username: user password: password + port: 830 validateCert: False hostTenantRelations: - .* = MyTenant