Suggestion or Bug Reporting

If you find any errors in Hyperbole’s operation or documentation, feel free to report them to <bug-hyperbole@gnu.org>. Be sure to use the {C-h h m r} Msg/Report-Hypb-Bug minibuffer menu item whenever you send a message to this address since that command will insert important system version information for you.

If you use Hyperbole mail or news support (see Buttons in Mail), a press of your Action Key on the Hyperbole mail list address will insert a description of your Hyperbole configuration information into your outgoing message, so that you do not have to type it. Otherwise, be sure to include the version numbers of your editor, Hyperbole and your window system. Your Hyperbole version number can be found in the top-level Hyperbole menu.

Below are some tips on how best to structure requests and discussion messages. If you share information about your use of Hyperbole with others, it will promote broader use and development of Hyperbole.

• Always use your Subject lines to state the position that your message takes on the topic that it addresses.

  For example, write: “Subject: Typo in top-level Hyperbole minibuffer menu.”
  
  rather than: “Subject: Hyperbole bug”

• Statements end with periods, questions with question marks (typically), and high energy, high impact declarations with exclamation points. These simple rules make all e-mail communication much easier for recipients to handle appropriately.
• Question messages should normally include your Hyperbole and Emacs version numbers and should clearly explain your problem and surrounding issues. Otherwise, it is difficult for anyone to answer your question. (Your top-level Hyperbole menu shows its version number and {M-x emacs-version RET} gives the other.)
• If you ask questions, you should consider adding to the discussion by telling people the kinds of work you are doing or contemplating doing with Hyperbole. In this way, the list is not overrun by messages that ask for, but provide no information.

If you have suggestions on how to improve Hyperbole, send them to <hyperbole-users@gnu.com> ({C-h h m c} minibuffer menu item Msg/Compose-Hypb-Mail). Here are some issues you might address:

• What did you like and dislike about the system?
• What kinds of tasks, if any, does it seem to help you with?
• What did you think of the Emacs-based user interface?
• How was the Hyperbole Manual and other documentation?
• Was the setup trivial, average or hard?
• What areas of Hyperbole would you like to see expanded/added?
• How does it compare to other hypertext tools you have used?
• Was it easy or difficult to create your own types? Why?
• Did you get any use out of the external system encapsulations?