Skip to content

Github Create Issue button need refactoring #3517

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Tracked by #3516
LasneF opened this issue Jan 22, 2024 · 1 comment · Fixed by #3713
Closed
Tracked by #3516

Github Create Issue button need refactoring #3517

LasneF opened this issue Jan 22, 2024 · 1 comment · Fixed by #3713

Comments

@LasneF
Copy link
Member

LasneF commented Jan 22, 2024

currently the button new issue

lead to this page
image

that does contains plenty of links to the documentation but not a visible way to "open" an issue

this is due to this files
https://github.com/OAI/OpenAPI-Specification/blob/main/.github/ISSUE_TEMPLATE/config.yml

i would suggest to leverage several files , and a keep it simple approach

  • Bug Report
  • Feature Request
  • Question

associating a dedicated label automatically

following for instance for bug report

---
name: Bug report
about: Create a report to help us improve
labels: bug
---

**Describe the bug**

**Expected behavior**

**Additional context**

we could also mentionned the version of OAS affected

@handrews
Copy link
Member

Thanks, @LasneF! I have added this to the clean-up meta-issue task list.

Warning: stream-of-consciousness ramble ahead...

Some of these are intended to route folks to other places for some of the most common ways people misunderstand this repo, which I think is a good thing. But they need to be clearer, preferably by linking to another issue-filing form (e.g. the tooling one should actually open an issue on the OAI/Tooling repo). Any that cannot link to an issue-filing form need to have their text clarified as to why the button goes where it goes, so folks don't just come right back and file a blank issue.

For example, we should direct people to the Slack to ask questions because it's much easier to answer them there than to manage them as GitHub issues, so that one wouldn't go to an issue form.

We should definitely keep the registries as their own template, even though I think it is also in this repo (as part of the gh-pages branch). The workflow for those is quite different from specification issues.

We should also link off to the Moonwalk repository discussions, with an explanation that if something requires a major change, it is better opened as a discussion there. Only minor or patch-level feature requests and bugfixes (as defined by semver) go in this repository. Requesting the OAS version that they're talking about will help with this (and can also be an opportunity to clarify that no work will be done on the 2.x line).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Done
Status: Done
Development

Successfully merging a pull request may close this issue.

2 participants