Skip to content

Commit

Permalink
Add contributing guide
Browse files Browse the repository at this point in the history
Update howto-release.txt
Create ISSUE_TEMPLATE

Bugs: #157
  • Loading branch information
oxr463 committed Apr 6, 2019
1 parent 04e7edc commit 88437e9
Show file tree
Hide file tree
Showing 3 changed files with 69 additions and 1 deletion.
41 changes: 41 additions & 0 deletions HACKING.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
==============================
Contributing to PRoot / CARE
==============================

-----------------------------------------------------------
An introduction to contributing to PRoot / CARE development
-----------------------------------------------------------

The PRoot Team welcomes, and depends, on contributions from students and
collaborators in the open source and academic communities.
Contributions can be made in a number of ways, a few examples are:

- Code patches via pull requests
- Documentation improvements
- Bug reports and patch reviews

Reporting an Issue
==================

Please include as much detail as you can. Let us know your host kernel
version, e.g, :code:`uname -a`, host/guest distribution, e.g. :code:`cat /etc/os-release`,
and the :code:`PRoot`/:code:`CARE` version number. If you get an error please include the full
error and/or traceback. Issues are tracked on GitHub at <https://github.com/proot-me/proot/issues>,
or can also be sent via the `mailing list <mailto:proot_me@googlegroups.com>`_.

Submitting Pull Requests
========================

Once you are happy with your changes or you are ready for some feedback, push
it to your fork and send a pull request. For a change to be accepted it will
most likely need to have updated tests and/or documentation. New features
**require** additional tests in order to be included in a future release.

Resources
=========

- `Contributing to Open Source Projects <http://www.contribution-guide.org>`_

- `How To Ask Questions The Smart Way <http://www.catb.org/esr/faqs/smart-questions.html>`_

- `Indentation Style - Wikipedia <https://en.wikipedia.org/wiki/Indentation_style#K&R_style>`_
27 changes: 27 additions & 0 deletions ISSUE_TEMPLATE
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
## Expected Behavior

## Actual Behavior


## Steps to Reproduce the Problem

1.
2.
3.

## Specifications

- Proot/Care version:
- Kernel version:
- Host distribution:
- Guest distribution:

## Command Output

```terminal
Inline log
```

-OR-

[Attached log]()
2 changes: 1 addition & 1 deletion doc/howto-release.txt
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Checks

where "/usr/bin/true" is a symlink to "/bin/true".

+ Static analysis: Coverity Scan and Clang Scan Build must not report
+ Static analysis: Gcov/Lcov and Clang Scan Build must not report
new issues.


Expand Down

0 comments on commit 88437e9

Please sign in to comment.