This repository has been archived by the owner on Feb 25, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 30
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: improve doc string and add issue and PR template (#113)
* improve doc strings for operator methods * docs: template for PR and Issues * bentoctl specific changes * fix contact links
- Loading branch information
Showing
4 changed files
with
133 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
--- | ||
name: Bug Report | ||
about: Create a report to help us improve | ||
title: '' | ||
labels: 'bug' | ||
assignees: '' | ||
|
||
--- | ||
|
||
**Describe the bug** | ||
<!--- A clear and concise description of what the bug is. --> | ||
|
||
|
||
**To Reproduce** | ||
<!-- | ||
Steps to reproduce the issue: | ||
1. Go to '...' | ||
2. Click on '....' | ||
3. Scroll down to '....' | ||
4. See error | ||
--> | ||
|
||
**Expected behavior** | ||
<!--- A clear and concise description of what you expected to happen. --> | ||
|
||
**Screenshots/Logs** | ||
<!--- | ||
If applicable, add screenshots, logs or error outputs to help explain your problem. | ||
To give us more information for diagnosing the issue, make sure to enable debug logging for both bentoctl and BentoML: | ||
Enable via environment variable, e.g.: | ||
``` | ||
$ git clone git@github.com:bentoml/BentoML.git && cd bentoml | ||
$ BENTOCTL_DEBUG=True BENTOML_DEBUG=TRUE python guides/quick-start/main.py | ||
``` | ||
Or set debug logging in your Python code: | ||
```python | ||
from bentoml.configuration import set_debug_mode | ||
set_debug_mode(True) | ||
``` | ||
For bentoctl CLI commands, simply add the `--verbose` flag, e.g.: | ||
```bash | ||
bentoctl init --verbose | ||
``` | ||
--> | ||
|
||
|
||
**Environment:** | ||
- OS: [e.g. MacOS 10.14.3] | ||
- Python Version [e.g. Python 3.7.1] | ||
- BentoML Version [e.g. BentoML-0.8.6] | ||
- Bentoctl Version [e.g. bentoctl-0.1] | ||
|
||
|
||
**Additional context** | ||
<!-- Add any other context about the problem here. e.g. links to related discussion. --> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
contact_links: | ||
- name: Bentoctl Discussions | ||
url: https://github.com/bentoml/bentoctl/discussions | ||
about: Please ask general questions here. | ||
- name: BentoML/bentoctl Slack Community | ||
url: https://join.slack.bentoml.org | ||
about: For connecting with others in the community | ||
- name: BentoML/bentoctl Enterprise Support | ||
url: contact@bentoml.ai | ||
about: Contact the BentoML team and learn more |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
--- | ||
name: Feature Request | ||
about: Suggest a new feature for bentoctl | ||
title: '' | ||
labels: 'new feature' | ||
assignees: '' | ||
|
||
--- | ||
|
||
**Is your feature request related to a problem? Please describe.** | ||
<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] --> | ||
|
||
**Describe the solution you'd like** | ||
<!-- A clear and concise description of what you want to happen. --> | ||
|
||
**Describe alternatives you've considered** | ||
<!-- A clear and concise description of any alternative solutions or features you've considered. --> | ||
|
||
**Additional context** | ||
<!-- Add any other context or screenshots about the feature request here. --> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,43 @@ | ||
<!--- Thanks for sending a pull request! | ||
Please make sure to read the contribution guidelines, then fill out the blanks below before requesting a code review. | ||
Name your Pull Request with one of the following prefixes, e.g. "feat: add support for PyTorch", to indicate the type of changes proposed. This is based on the [Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/#summary). | ||
- feat: (new feature for the user, not a new feature for build script) | ||
- fix: (bug fix for the user, not a fix to a build script) | ||
- docs: (changes to the documentation) | ||
- style: (formatting, missing semicolons, etc; no production code change) | ||
- refactor: (refactoring production code, eg. renaming a variable) | ||
- perf: (code changes that improve performance) | ||
- test: (adding missing tests, refactoring tests; no production code change) | ||
- chore: (updating grunt tasks etc; no production code change) | ||
- build: (changes that affect the build system or external dependencies) | ||
- ci: (changes to configuration files and scripts) | ||
- revert: (reverts a previous commit) | ||
--> | ||
|
||
## Description | ||
<!--- Describe your changes in detail --> | ||
<!--- Attach screenshots here if appropriate. --> | ||
|
||
## Motivation and Context | ||
<!--- Why is this change required? What problem does it solve? --> | ||
<!--- If it fixes an open issue, please link to the issue here. --> | ||
<!--- If it is based on a conversation in slack channel, pls quote related messages here --> | ||
|
||
## How Has This Been Tested? | ||
<!--- Please describe in detail how you tested your changes. --> | ||
<!--- Include details of your testing environment, and the tests you ran to --> | ||
<!--- see how your change affects other areas of the code, etc. --> | ||
|
||
## Checklist: | ||
<!--- Go over all the following points, and put an `x` in all the boxes that apply. --> | ||
<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! --> | ||
<!--- If you plan to update documentation or tests in follow-up, please note --> | ||
- [ ] My code follows the bentoctl code style, both `make format` and | ||
`make lint` script have passed | ||
- [ ] My change reduces project test coverage and requires unit tests to be added | ||
- [ ] I have added unit tests covering my code change | ||
- [ ] My change requires a change to the documentation | ||
- [ ] I have updated the documentation accordingly |