From: Gervase Markham Date: Mon, 15 Sep 2014 11:29:04 +0000 (+0800) Subject: WIP X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=acce4dbe67bc0e1576bcc927cd4345b9481ab20a;p=thirdparty%2Fbugzilla.git WIP --- diff --git a/docs/en/rst/extensions/example.rst b/docs/en/rst/extensions/example.rst deleted file mode 100644 index 07b355887f..0000000000 --- a/docs/en/rst/extensions/example.rst +++ /dev/null @@ -1,22 +0,0 @@ -Example -####### - -This is a sample documentation file for the Example extension. Like all of -the Bugzilla docs, it's written in -`reStructured Text (reST) format `_ -and will be compiled by `Sphinx `_. - -If you build the docs yourself using :file:`makedocs.pl`, this file will get -incorporated into the Extensions chapter, as will any documentation -you write for your extensions which fulfils the following criteria: - -* In the :file:`extensions/YourExtension/doc/` directory -* Has a :file:`.rst` file extension - -You are recommended to make the name of your reST doc file the same as the -name of your extension, so that there is no clash when all the extension -documentation is copied into the same directory. So, for example, this file -is called :file:`example.rst`, as it's part of the Example extension. If you -need multiple documentation files, prefix the filename with the name of your -extension, e.g. :file:`example-extra.rst`. - diff --git a/extensions/Voting/doc/voting.rst b/extensions/Voting/doc/voting.rst new file mode 100644 index 0000000000..d114a45983 --- /dev/null +++ b/extensions/Voting/doc/voting.rst @@ -0,0 +1,34 @@ +.. _voting: + +Voting +###### + +To enable the Voting exteion, you must remove the :file:`disabled` +file from the directory :file:`extensions/Voting/`, and run +:file:`checksetup.pl`. + +Voting allows users to be given a pot of votes which they can allocate +to bugs, to indicate that they'd like them fixed. +This allows developers to gauge +user need for a particular enhancement or bugfix. By allowing bugs with +a certain number of votes to automatically move from "UNCONFIRMED" to +"CONFIRMED", users of the bug system can help high-priority bugs garner +attention so they don't sit for a long time awaiting triage. + +To modify Voting settings, navigate to the "Edit product" screen for the +Product you wish to modify. The following settings are available: + +*Maximum votes per person:* + Setting this field to "0" disables voting. + +*Maximum votes a person can put on a single bug:* + It should probably be some number lower than the + "Maximum votes per person". Don't set this field to "0" if + "Maximum votes per person" is non-zero; that doesn't make + any sense. + +*Number of votes a bug in this product needs to automatically get out of the UNCONFIRMED state:* + Setting this field to "0" disables the automatic move of + bugs from UNCONFIRMED to CONFIRMED. + +Once you have adjusted the values to your preference, click "Update".