Skip to content

Commit

Permalink
docs: adding github issue templates and updating readme (#345)
Browse files Browse the repository at this point in the history
  • Loading branch information
bl4ko committed Nov 26, 2024
1 parent 8f888df commit 4f53ff7
Show file tree
Hide file tree
Showing 3 changed files with 192 additions and 0 deletions.
130 changes: 130 additions & 0 deletions .github/ISSUE_TEMPLATE/bug.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
name: Bug Report
description: Report a bug or issue with netbox-ssot
title: "[Bug] <title>"
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"
61 changes: 61 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -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)
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -197,6 +197,7 @@ source:
hostname: 10.10.1.1
username: user
password: password
port: 830
validateCert: False
hostTenantRelations:
- .* = MyTenant
Expand Down

0 comments on commit 4f53ff7

Please sign in to comment.