Skip to content

Commit 8f5d80b

Browse files
Merge pull request #4 from ranas-mukminov/copilot/update-repo-documentation
Complete documentation and repository infrastructure for run-as-daemon fork
2 parents dabb491 + 4dfa028 commit 8f5d80b

File tree

13 files changed

+981
-1015
lines changed

13 files changed

+981
-1015
lines changed

.github/FUNDING.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,4 @@
1-
github: ["ranas-mukminov"]
1+
# These are supported funding model platforms
2+
3+
github: [ranas-mukminov]
24
custom: ["https://run-as-daemon.ru/support"]
Lines changed: 49 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,61 @@
11
name: Bug Report
2-
description: Report a bug or issue with the MongoDB Grafana datasource plugin
3-
title: "[Bug]: "
2+
description: Report a bug or issue with the MongoDB Grafana plugin
3+
title: "[BUG] "
44
labels: ["bug", "needs-triage"]
5+
assignees: []
6+
57
body:
68
- type: markdown
79
attributes:
810
value: |
9-
Thanks for taking the time to report a bug! Please fill out the information below to help us diagnose and fix the issue.
11+
Thank you for reporting a bug! Please fill out the information below to help us resolve the issue.
1012
1113
- type: textarea
1214
id: description
1315
attributes:
1416
label: Bug Description
1517
description: A clear and concise description of what the bug is.
16-
placeholder: What happened?
18+
placeholder: Describe the bug...
1719
validations:
1820
required: true
1921

2022
- type: textarea
21-
id: steps-to-reproduce
23+
id: steps
2224
attributes:
2325
label: Steps to Reproduce
2426
description: Steps to reproduce the behavior
2527
placeholder: |
2628
1. Go to '...'
27-
2. Click on '...'
28-
3. Execute query '...'
29+
2. Configure '...'
30+
3. Run query '...'
2931
4. See error
3032
validations:
3133
required: true
3234

3335
- type: textarea
34-
id: expected-behavior
36+
id: expected
3537
attributes:
3638
label: Expected Behavior
37-
description: What did you expect to happen?
38-
placeholder: I expected...
39+
description: What you expected to happen
40+
placeholder: Describe what should happen...
3941
validations:
4042
required: true
4143

4244
- type: textarea
43-
id: actual-behavior
45+
id: actual
4446
attributes:
4547
label: Actual Behavior
46-
description: What actually happened?
47-
placeholder: Instead, I got...
48+
description: What actually happened
49+
placeholder: Describe what actually happened...
4850
validations:
4951
required: true
5052

51-
- type: textarea
52-
id: query
53-
attributes:
54-
label: MongoDB Query
55-
description: If applicable, paste the MongoDB aggregation query that's causing the issue
56-
placeholder: |
57-
db.collection.aggregate([
58-
{ "$match": { ... } }
59-
])
60-
render: javascript
61-
6253
- type: input
6354
id: grafana-version
6455
attributes:
6556
label: Grafana Version
6657
description: What version of Grafana are you using?
67-
placeholder: e.g., 9.5.2, 10.0.0
58+
placeholder: e.g., 10.2.0
6859
validations:
6960
required: true
7061

@@ -73,15 +64,15 @@ body:
7364
attributes:
7465
label: MongoDB Version
7566
description: What version of MongoDB are you using?
76-
placeholder: e.g., 5.0.15, 6.0.4
67+
placeholder: e.g., 6.0.3
7768
validations:
7869
required: true
7970

8071
- type: input
8172
id: plugin-version
8273
attributes:
8374
label: Plugin Version
84-
description: What version of the MongoDB Grafana plugin are you using?
75+
description: What version of the mongodb-grafana plugin are you using?
8576
placeholder: e.g., 0.8.1
8677
validations:
8778
required: true
@@ -90,38 +81,45 @@ body:
9081
id: nodejs-version
9182
attributes:
9283
label: Node.js Version
93-
description: What version of Node.js is running the proxy server?
94-
placeholder: e.g., 16.20.0, 18.16.0
84+
description: What version of Node.js is the proxy server running on?
85+
placeholder: e.g., 16.20.0
9586
validations:
96-
required: true
87+
required: false
9788

9889
- type: dropdown
99-
id: deployment
90+
id: os
10091
attributes:
101-
label: Deployment Method
102-
description: How are you deploying the plugin and proxy?
92+
label: Operating System
93+
description: What operating system are you using?
10394
options:
104-
- Manual installation
105-
- Docker Compose
106-
- Kubernetes
107-
- Other (please describe in additional context)
95+
- Linux
96+
- macOS
97+
- Windows
98+
- Docker
99+
- Other
108100
validations:
109101
required: true
110102

111-
- type: input
112-
id: os
103+
- type: textarea
104+
id: query
113105
attributes:
114-
label: Operating System
115-
description: What OS is the proxy server running on?
116-
placeholder: e.g., Ubuntu 22.04, macOS 13.3, Windows 11
117-
validations:
118-
required: true
106+
label: MongoDB Query
107+
description: If applicable, paste the MongoDB aggregation query you're using
108+
placeholder: |
109+
db.collection.aggregate([
110+
// Your query here
111+
])
112+
render: javascript
119113

120114
- type: textarea
121115
id: logs
122116
attributes:
123117
label: Relevant Logs
124-
description: Please paste any relevant log output (proxy server logs, Grafana logs, browser console)
118+
description: |
119+
Please include relevant log output from:
120+
- Grafana server logs
121+
- MongoDB proxy logs
122+
- Browser console (if applicable)
125123
placeholder: Paste logs here...
126124
render: shell
127125

@@ -132,22 +130,22 @@ body:
132130
description: If applicable, add screenshots to help explain your problem
133131

134132
- type: textarea
135-
id: additional-context
133+
id: additional
136134
attributes:
137135
label: Additional Context
138-
description: Add any other context about the problem here (network setup, security configuration, etc.)
136+
description: Add any other context about the problem here
139137

140138
- type: checkboxes
141139
id: checklist
142140
attributes:
143141
label: Pre-submission Checklist
144-
description: Please confirm you've done the following before submitting
142+
description: Please confirm the following before submitting
145143
options:
146-
- label: I have searched existing issues to ensure this isn't a duplicate
144+
- label: I have searched existing issues to ensure this bug hasn't been reported
147145
required: true
148146
- label: I have included all relevant version information
149147
required: true
150148
- label: I have provided steps to reproduce the issue
151149
required: true
152-
- label: I have checked the plugin and proxy logs for errors
153-
required: true
150+
- label: I have included relevant logs or error messages
151+
required: false
Lines changed: 52 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,23 @@
11
name: Feature Request
2-
description: Suggest a new feature or enhancement for the MongoDB Grafana datasource plugin
3-
title: "[Feature]: "
2+
description: Suggest a new feature or enhancement for the MongoDB Grafana plugin
3+
title: "[FEATURE] "
44
labels: ["enhancement", "needs-triage"]
5+
assignees: []
6+
57
body:
68
- type: markdown
79
attributes:
810
value: |
9-
Thanks for suggesting a new feature! Please provide as much detail as possible to help us understand your request.
11+
Thank you for suggesting a feature! Please fill out the information below.
12+
13+
**Note**: This is a community-maintained fork. Feature implementation depends on community contributions and maintainer availability.
1014
1115
- type: textarea
1216
id: problem
1317
attributes:
1418
label: Problem Statement
1519
description: Is your feature request related to a problem? Please describe.
16-
placeholder: I'm always frustrated when...
20+
placeholder: I'm frustrated when... / I need to... / It would be helpful if...
1721
validations:
1822
required: true
1923

@@ -22,30 +26,32 @@ body:
2226
attributes:
2327
label: Proposed Solution
2428
description: Describe the solution you'd like to see
25-
placeholder: I would like to be able to...
29+
placeholder: I would like to see... / The plugin should... / It would work like...
2630
validations:
2731
required: true
2832

2933
- type: textarea
3034
id: alternatives
3135
attributes:
3236
label: Alternatives Considered
33-
description: Have you considered any alternative solutions or workarounds?
34-
placeholder: I've tried... but it doesn't work because...
37+
description: Describe any alternative solutions or features you've considered
38+
placeholder: |
39+
- Alternative 1: ...
40+
- Alternative 2: ...
41+
- Current workaround: ...
3542
3643
- type: dropdown
37-
id: feature-type
44+
id: component
3845
attributes:
39-
label: Feature Type
40-
description: What type of feature is this?
46+
label: Component
47+
description: Which component would this feature affect?
4148
options:
42-
- New query capability
43-
- Dashboard/visualization enhancement
44-
- Proxy server improvement
45-
- Performance optimization
46-
- Documentation improvement
47-
- Security enhancement
48-
- Developer experience
49+
- Grafana Plugin (Frontend UI)
50+
- MongoDB Proxy Server (Backend)
51+
- Query Handling
52+
- Configuration
53+
- Documentation
54+
- Build/Deployment
4955
- Other
5056
validations:
5157
required: true
@@ -56,9 +62,10 @@ body:
5662
label: Priority
5763
description: How important is this feature to you?
5864
options:
59-
- Nice to have
60-
- Would significantly improve my workflow
61-
- Critical for my use case
65+
- Critical - Blocking my use of the plugin
66+
- High - Significantly improves my workflow
67+
- Medium - Nice to have enhancement
68+
- Low - Minor improvement
6269
validations:
6370
required: true
6471

@@ -68,65 +75,62 @@ body:
6875
label: Use Case
6976
description: Describe your specific use case for this feature
7077
placeholder: |
71-
I need this feature because...
72-
It would help me to...
73-
My workflow involves...
78+
In my project, we need to...
79+
We have X number of dashboards that...
80+
Our team frequently needs to...
7481
validations:
7582
required: true
7683

7784
- type: textarea
7885
id: example
7986
attributes:
8087
label: Example
81-
description: If applicable, provide an example of how this feature would work
88+
description: If applicable, provide a concrete example of how this feature would be used
8289
placeholder: |
83-
For example, I would write a query like:
84-
db.collection.aggregate([...])
85-
86-
And it would produce...
90+
1. User configures...
91+
2. User runs query...
92+
3. System displays...
8793
8894
- type: textarea
8995
id: mockup
9096
attributes:
91-
label: Mockups or Examples
92-
description: If applicable, add mockups, screenshots, or examples from other tools
97+
label: Mockup/Screenshot
98+
description: If applicable, add mockups or screenshots to help explain your feature
9399

94100
- type: checkboxes
95-
id: compatibility
101+
id: upstream
96102
attributes:
97-
label: Compatibility
98-
description: Should this feature maintain backward compatibility?
103+
label: Upstream Compatibility
104+
description: Should this feature be compatible with the upstream project?
99105
options:
100-
- label: This feature should maintain backward compatibility
101-
- label: This feature may require breaking changes (explain in additional context)
106+
- label: This feature should maintain compatibility with JamesOsgood/mongodb-grafana
107+
- label: This is a fork-specific enhancement that doesn't need upstream compatibility
102108

103-
- type: dropdown
109+
- type: checkboxes
104110
id: contribution
105111
attributes:
106112
label: Contribution
107-
description: Are you willing to contribute this feature?
113+
description: Are you willing to contribute to implementing this feature?
108114
options:
109-
- No, I'm just suggesting it
110-
- Yes, I'm willing to submit a pull request
111-
- Yes, but I need guidance on how to implement it
112-
validations:
113-
required: true
115+
- label: I am willing to submit a pull request for this feature
116+
- label: I can help test this feature once implemented
117+
- label: I can help with documentation for this feature
114118

115119
- type: textarea
116-
id: additional-context
120+
id: additional
117121
attributes:
118122
label: Additional Context
119-
description: Add any other context, links, or references about the feature request here
123+
description: Add any other context, links, or references about the feature request
120124

121125
- type: checkboxes
122126
id: checklist
123127
attributes:
124128
label: Pre-submission Checklist
125-
description: Please confirm you've done the following before submitting
129+
description: Please confirm the following before submitting
126130
options:
127-
- label: I have searched existing issues and discussions to ensure this isn't a duplicate
131+
- label: I have searched existing issues to ensure this hasn't been requested
128132
required: true
129-
- label: I have clearly described the problem and proposed solution
133+
- label: I have described the problem and proposed solution clearly
130134
required: true
131-
- label: I understand this is an open-source project with no guaranteed timelines
135+
- label: I understand this is a community project with no guaranteed implementation timeline
132136
required: true

0 commit comments

Comments
 (0)