Skip to content
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

Add Issue templates #117

Merged
merged 1 commit into from
Mar 1, 2021
Merged

Conversation

adrianchiris
Copy link
Collaborator

@adrianchiris adrianchiris commented Feb 28, 2021

This commit adds templates for possible issues
that can be opened against Network Operator project

  • Bug report template: To be used when reporting
    a possible bug in network-operator
  • Enhancement template: To be used when requesting
    an enhancement/feature of network operator
  • Release template: To be used when creating a new release
    of network-operator. This includes a checklist of actions
    that should be done in order to release a new version
    of network-operator

Signed-off-by: Adrian Chiris adrianc@nvidia.com

@adrianchiris
Copy link
Collaborator Author

cc @e0ne

@adrianchiris
Copy link
Collaborator Author

adrianchiris commented Feb 28, 2021

As an improvement down the road we should IMO:

  • Automate updates to release version on master
  • Automate updates to gh-pages when we do a release

**lets first agree on the release process as proposed by this PR and then ill open an issue to automate it.

@@ -0,0 +1,13 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It has been suggested by @e0ne that this may not be required as a bug template may be used instead.
Upside of having this is that this template will force the issuer to read the comment below before opening.

Im fine either way (remove/keep).

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't get this comment. is it on the "Support Request" template?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes, the comment is whether or not we need this template.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will remove it.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This issue will make the process more complicated. IMO, feature requests and bug reports should be enough.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

right, we agree to remove it


**Logs**:
- NicClusterPolicy CR spec and state:
- Output of: `kubectl -n mlnx-network-operator-resources get -A`:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume in the future we should change it to nvidia-network-operator-resources

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes, perhaps we should do it sooner rather than later, you want me to push PR for it ?

- Hardware configuration:
- OS (e.g: `cat /etc/os-release`):
- Kernel (e.g. `uname -a`):
- Others:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please add

  • NIC
  • FW

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ack

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see it updated

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

its under hardware configuration above

---
name: New Release
about: Propose a new release
title: Release vX.y.z
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why the X.y.z and not x.y.z?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesn't really matter, wanted to emphasise the "Major" version.
if i had a smaller "z" i would have put it.

I can make it x.y.z if it looks nasty.

- [ ] Changelog for current release with: `New Features`, `Bug Fixes`, `Known Limitations`
- [ ] Release artifacts for current release
- [ ] Add link to https://mellanox.github.io/network-operator
- [ ] Update gh-pages branch
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if we capture it in the issue we can remove the release.md in gh_pages

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes i will remove it.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will be removed in a separate PR as its a separte branch

- [ ] Create release in github
- [ ] Changelog for current release with: `New Features`, `Bug Fixes`, `Known Limitations`
- [ ] Release artifacts for current release
- [ ] Add link to https://mellanox.github.io/network-operator
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no need on second thought, i will remove.

originally i wanted to reference our github pages from the github release. but thinking on it more, i dont think its needed.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missed that sorry

- [ ] Ensure Helm CI is passing on updated Chart.
- [ ] Tag release
- [ ] Create release in github
- [ ] Changelog for current release with: `New Features`, `Bug Fixes`, `Known Limitations`
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

where is the changelog is captured?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it is captured in two places

  1. in the release issue
  2. in the github release itself (when you draft a release, you can fill info about the release.)

The description of the release will contain 3 sections : New features, bug fixes, known limitations.
i will explain it better here.

@@ -0,0 +1,13 @@
---
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't get this comment. is it on the "Support Request" template?

- [ ] Submit PR against `gh-pages` branch:
```
> git add <helm .tgz package> <release/index.yaml> <README.md>
> git commit --signoff -m "Release Network-Operator vX.y.z"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/vX/vx

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ack

@adrianchiris
Copy link
Collaborator Author

comments addressed. @moshe010 @e0ne

This commit adds templates for possible issues
that can be opened against Network Operator project

- Bug report template: To be used when reporting
  a possible bug in network-operator
- Enhancement template: To be used when requesting
  an enhancement/feature of network operator
- Release template: To be used when creating a new release
  of network-operator. This includes a checklist of actions
  that should be done in order to release a new version
  of network-operator

Signed-off-by: Adrian Chiris <adrianc@nvidia.com>
@moshe010 moshe010 merged commit fec2c56 into Mellanox:master Mar 1, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants