File: contributing.rst

package info (click to toggle)
circuits 2.1.0-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 7,384 kB
  • ctags: 3,037
  • sloc: python: 14,416; makefile: 146; sh: 61
file content (51 lines) | stat: -rw-r--r-- 1,641 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
Contributing to circuits
========================

Here's how you can contribute to circuits


Share your story
----------------


One of the best ways you can contribute to circuits is by using circuits.
Share with us your story of how you've used circuits to solve a problem
or create a new software solution using the circuits framework and library
of components. See our :doc:`Users Page </users>`.


Submitting Bug Reports
----------------------


We welcome all bug reports. We do however prefer bug reports in a clear
and concise form with repeatable steps. One of the best ways you can report
a bug to us is by writing a unit test (//similar to the ones in our tests//)
so that we can verify the bug, fix it and commit the fix along with the test.

To submit a bug report, please use:
 http://bitbucket.org/prologic/circuits/issues


Writing new tests
-----------------


We're not perfect, and we're still writing more tests to ensure quality code.
If you'd like to help, please `Fork circuits-dev <https://bitbucket.org/prologic/circuits-dev/fork>`_, write more tests that cover more of our code base and
submit a `Pull Request <https://bitbucket.org/prologic/circuits-dev/pull-request/new>`_. Many Thanks!


Adding New Features
-------------------


If you'd like to see a new feature added to circutis, then we'd like to hear
about it~ We would like to see some discussion around any new features as well
as valid use-cases. To start the discussions off, please either:

- `Chat to us on #circuits on the FreeNode IRC Network <http://freenode.org>`_

  or

- `Submit a NEW Issue <http://bitbucket.org/prologic/circuits/issues>`_