HowTo:POV-Ray Feature Requests

From POV-Wiki
Revision as of 12:39, 19 November 2016 by Wfpokorny (talk | contribs) (Updating this section for github issues over our older FlySpray issue tracker.)
Jump to navigation Jump to search

We all want to see POV-Ray improved, and from time to time it may occur to us that there's a feature that we would like to see, or something we'd like to see improved. The proper place for "feature wishlists" is the bugtracking and feature-request system on Github, as that's the primary place where the developers will look for them.

Note: We are in the process of porting issues still open in our previous FlySpray System to the new Github Issue Tracking System. During this transition it is necessary to review both systems to know if a feature equest has already been made known to the developers. Please open all new requests in the Github Issue Tracking System. If a FlySpray issue is marked as 'tracked on github' please make any further comments or updates on github.

When making feature requests, a word of advice:

Please do read HowTo:Make A Bug Report and How to Report Bugs Effectively before submitting any entries to the issue tracker, and do heed the advice presented there. By following those rules - or at least keeping them in mind as you file issues - you make life a lot easier for the people you hope to address the issues.

Some other points raised in [1] and [2]:

  • If discussion of a feature request has resulted in a summary or conclusion that differs from the original request, a new feature request should not be made. Instead, the existing one should be changed. This implies contributing ideas to the feature request discussion, and then coming up with a single coherent idea, not leaving it at two half-finished ideas.
  • Closely-related feature requests should be grouped together; e.g. requests for Windows UI enhancements with respect to the editor such as "Delete", "Reload" and "Rename" commands could reasonably be put into a single request (all at once or via editing a bug later).
  • There is a feature to allow other users and/or developers to comment on bugs & feature requests on github, but this is primarily intended for providing additional information, or feedback on the current status. For proper discussions, it lacks the necessary publicity. (When was the last time anyone just browsed the github just to see if there was some interesting discussion going on in some of the entries?) The POV-Ray community is strongest in the newsgroups. That said, the problem with discussions about feature requests is that they tend to have no clear-cut result whatsoever, as they tend do be free brainstorming sessions - unless there's someone with the necessary will and authority (e.g. because he has started the discussion in the first place) "driving" the discussion to a proper conclusion (ideally by summarizing the discussion and result in a proper place). In situations like these, github excels.
  • A sensible rule for opening a new feature request might then be that it must be discussed in the newsgroups first, to weed out crackpot ideas and to refine ideas by feedback from what users actually need. After discussion, the request should only be entered if a member of the POV-Ray team deems the request reasonable (note that a request should not be deemed unreasonable at this point just because it would be too much effort to implement right now).
  • Excessive use/misuse of the newsgroups and github may be considered "vandalism".