docs: Add github ISSUE_TEMPLATE

Adjust existing docs to better document running code from git

Signed-off-by: Cole Robinson <crobinso@redhat.com>
This commit is contained in:
Cole Robinson 2020-09-20 14:26:40 -04:00
parent 092a62552c
commit 81eae9b181
3 changed files with 43 additions and 9 deletions

17
.github/ISSUE_TEMPLATE.md vendored Normal file
View File

@ -0,0 +1,17 @@
<!--
Please only file issues if you have confirmed the issue is valid for
the latest virt-manager code. Running code from git is pretty easy,
see CONTRIBUTING.md for details.
If you are using distro provided packages and you have not confirmed
the bug exists in this repo, then please file a bug with your distro
instead.
If you are requesting a feature or UI change, please read DESIGN.md
first, especially the section at the end about previously rejected
features.
Thank you!
-->
**Distro**: <!-- FILL ME IN PLEASE -->

View File

@ -1,18 +1,32 @@
# Contribute to virt-manager # Contribute to virt-manager
## Run code from git
Generally virt-* tools can be run straight from git. For example
for virt-manager:
```
git clone https://github.com/virt-manager/virt-manager
cd virt-manager
./virt-manager --debug
```
The other tools like `virt-install` should work similarly. This
expects you already have a distro provided version of virt-manager
installed which pulled in all the necessary dependencies. If not,
see [INSTALL.md](INSTALL.md) for more hints about finding the
correct dependencies.
## Bug reporting ## Bug reporting
We use our [github issue tracker](https://github.com/virt-manager/virt-manager/issues) Bug reports should go to our [github issue tracker](https://github.com/virt-manager/virt-manager/issues).
for bug reporting. Previously we used bugzilla.redhat.com but nowadays
github is preferred.
Please only file issues if they apply to the latest version of The bug tracker is for issues affecting the latest code only.
virt-manager. If you are using an older version from a distro, If you are using a distro provided package like from Ubuntu or
please file a bug in your distro's bug tracker.. Fedora, please file a bug in their bug tracker.
When filing a bug, please reproduce the issue with the `--debug` If you suspect the bug also affects upstream code, please confirm
flag passed to the tool and attach the full output in the bug it by running the latest code using the steps above.
report.
## Writing patches ## Writing patches

View File

@ -6,6 +6,9 @@ changes, it can be done from the source directory:
./virt-manager ./virt-manager
``` ```
For more details on that, see [CONTRIBUTING.md](CONTRIBUTING.md)
To install the software into `/usr/local` (usually), you can do: To install the software into `/usr/local` (usually), you can do:
```sh ```sh
./setup.py install ./setup.py install