Quick replies

=============

Quick replies are reusable pieces of text that you can use to start a comment

on an issue or pull request. They are meant to remove the hassle of typing a

similar response again and again.

Examples where this can be handy:

* asking for a rebase of a pull request

* asking a person to add a ``Signed-off-by`` line to their commit

All these requests might be accompanied by a description on why it's requested.

With quick replies you can prepare the descriptions and the just use them with

a click of a button.

Using quick replies

-------------------

Any user that can comment will be able to use the quick reply. They are offered

in a drop down menu next to the *Preview* button above comment form.

.. image:: /_static/quick_replies.png

The button is only visible if the project has some quick replies defined.

Additionally, the button will become insensitive when you type something into

the comment box or switch to preview. This should avoid writing over your

carefully crafted comment by accident. If you remove the text from the field,

the button will work again.

Creating and modifying quick replies

------------------------------------

Project admins can create them in the settings section. There are no length

limits on the reply, but only the first 50 characters will be displayed in the

menu for users to choose from. This limitation should encourage you to put the

most important message at the beginning.

The order in which you define the replies will be preserved on the chooser

menu. This can be used to put the most frequently used ones on the top of the

list.