Skip to content

Commit

Permalink
Update issue templates for better user experience and incorporate OSB…
Browse files Browse the repository at this point in the history
… logo into README (#534)

Signed-off-by: Ian Hoang <[email protected]>
Co-authored-by: Ian Hoang <[email protected]>
  • Loading branch information
IanHoang and Ian Hoang authored May 30, 2024
1 parent 3d9ca6e commit f194726
Show file tree
Hide file tree
Showing 8 changed files with 154 additions and 92 deletions.
27 changes: 0 additions & 27 deletions .github/ISSUE_TEMPLATE/bug_template.md

This file was deleted.

51 changes: 51 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_template.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
name: Bug Report 🐛
description: File a bug report
title: '[Bug]: '
labels: [bug, untriaged]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to fill out this bug report!
- type: textarea
id: what-happened
attributes:
label: Describe the bug
description: A clear and concise description of what the bug is.
validations:
required: true
- type: textarea
id: to-Reproduce
attributes:
label: To reproduce
description: Steps to reproduce the behavior
validations:
required: true
- type: textarea
id: Expected-behaviour
attributes:
label: Expected behavior
description: A clear and concise description of what you expected to happen.
- type: textarea
id: screenshots
attributes:
label: Screenshots
description: Attach the screenshots associated with this issue
value: If applicable, add screenshots to help explain your problem.
- type: textarea
id: Host-Environment
attributes:
label: Host / Environment
description: Hosts / Environment information to reproduce this bug
- type: textarea
id: additional-context
attributes:
label: Additional context
description: Add any other context about the problem here.
- type: textarea
id: logs
attributes:
label: Relevant log output
description: Please copy and paste any relevant log output. This will be automatically formatted into code, so please don't insert Markdown backticks.
render: shell
23 changes: 0 additions & 23 deletions .github/ISSUE_TEMPLATE/feature_template.md

This file was deleted.

33 changes: 33 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_template.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
name: Feature request 🎆
description: Suggest a new feature or an idea you have for this project
labels: [enhancement, untriaged]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to submit a feature request!
- type: textarea
id: feature
attributes:
label: Is your feature request related to a problem? Please describe
description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
validations:
required: true
- type: textarea
id: solution
attributes:
label: Describe the solution you'd like
description: A clear and concise description of what you want to happen.
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Describe alternatives you've considered
description: A clear and concise description of any alternative solutions or features you've considered.
- type: textarea
id: additional-context
attributes:
label: Additional context
description: Add any other context or screenshots about the feature request here.
40 changes: 0 additions & 40 deletions .github/ISSUE_TEMPLATE/proposal_template.md

This file was deleted.

69 changes: 69 additions & 0 deletions .github/ISSUE_TEMPLATE/proposal_template.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
name: Proposal
description: Suggest an idea for a specific feature you wish to propose to the community for comment
title: '[RFC/PROPOSAL]: '
labels: [RFC, untriaged]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to fill out this RFC / Proposal!
- type: textarea
id: what-are-you-proposing
attributes:
label: What are you proposing?
description: In a few sentences, describe the feature and its core capabilities.
validations:
required: true
- type: textarea
id: what-users-have-asked-for-this-feature
attributes:
label: What users have asked for this feature?
description: Highlight any research, proposals, requests or anecdotes that signal this is the right thing to build. Include links to GitHub Issues, Forums, Stack Overflow, X (Twitter), Etc
validations:
required: true
- type: textarea
id: what-problems-are-you-trying-to-solve
attributes:
label: What problems are you trying to solve?
description: Summarize use cases, user problems, and needs you are trying to solve. Describe the most important user needs, pain points and jobs as expressed by the user asks above.
- type: textarea
id: what-will-developer-experience-be-like
attributes:
label: What will the developer experience be like?
description: Does this have a REST API? If so, please describe the API and any impact it may have to existing APIs. In a brief summary (not a spec), highlight what new REST APIs or changes to REST APIs are planned. as well as any other API, CLI or Configuration changes that are planned as part of this feature.
- type: textarea
id: are-there-any-security-coniderations
attributes:
label: Are there any security considerations?
description: Describe if the feature has any security considerations or impact. What is the security model of the new APIs? Features should be integrated into the OpenSearch security suite and so if they are not, we should highlight the reasons here
- type: textarea
id: are-there-any-breaking-changes
attributes:
label: Are there any breaking changes?
description: If this feature will require breaking changes to any APIs, ouline what those are and why they are needed. What is the path to minimizing impact? (example, add new API and deprecate the old one)
- type: textarea
id: what-will-the-user-experience-be-like
attributes:
label: What will the user experience be like?
description: Describe the feature requirements and/or user stories. You may include low-fidelity sketches, wireframes, APIs stubs, or other examples of how a user would use the feature via CLI. Using a bulleted list or simple diagrams to outline features is okay. If this is net new functionality, call this out as well.
- type: textarea
id: are-there-breaking-changes-to-user-experience
attributes:
label: Are there breaking changes to user experience?
description: Will this change the existing user experience? Will this be a breaking change from a user flow or user experience perspective?
- type: textarea
id: why-should-it-be-built
attributes:
label: Why should it be built? Any reason not to?
description: Describe the value that this feature will bring to the OpenSearch community, as well as what impact it has if it isn't built, or new risks if it is. Highlight opportunities for additional research.
- type: textarea
id: what-will-it-take-to-execute
attributes:
label: What will it take to execute?
description: Describe what it will take to build this feature. Are there any assumptions you may be making that could limit scope or add limitations? Are there performance, cost, or technical constraints that may impact the user experience? Does this feature depend on other feature work? What additional risks are there?
- type: textarea
id: any-remaining-open-questions
attributes:
label: Any remaining open questions?
description: What are the known enhancements to this feature? Are there any enhancements that may be out of scope but which we will want to track long term? List any other open questions that may need to be answered before proceeding with an implementation.
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
OpenSearch Benchmark
====================
<img src="https://raw.githubusercontent.com/opensearch-project/opensearch-benchmark/blob/main/opensearch_benchmark.png" height="64px" alt="OpenSearch Benchmark">

OpenSearch Benchmark is the macrobenchmarking framework for OpenSearch.

Expand Down
Binary file added opensearch_benchmark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f194726

Please sign in to comment.