Skip to content

Github Posting Rules

Andrew Bauer edited this page Aug 2, 2018 · 9 revisions

BACKGROUND

There are three places where the development team communicates with the community:

In order to maintain an accurate list of issues, which can be reasonably resolved by the development team, we are restricting our github forum to the criteria listed below. Our github forum is managed similar to Ubuntu's bugs.launchpad or Redhat's bugzilla. Be prepared to include a detailed report of your system, any relevant log files, and steps to reproduce the issue.

There are no such restrictions on our user forum or our Slack channel. Feel free to have general discussions in these areas.

ISSUE CRITERIA

The ZoneMinder github forum is intended for the following two purposes:

  • Bug Reports
  • *Serious Feature Requests

*Serious feature requests are defined to be those where the author is prepared to submit a pull request in a timely manner, or the author creates a bounty for the proposed feature to encourage someone else to do the work. If in doubt, join us in the ZoneMinder-Chat Slack channel and ask us.

All other questions and comments should be directed to the ZoneMinder user forum or the ZoneMinder-Chat Slack channel. Issues that do not fit this criteria will be closed.

REQUIRED INFORMATION

  • The exact version of ZoneMinder you are using.
  • We MUST know if you are running a development snapshot and how recent it is.
  • The *NIX Distribution you are using and its version.
  • How you installed ZoneMinder. From source? zmrepo? ppa? third party?
  • If the issue concerns a camera, provide the following:
    • Camera Make and Model
    • Camera framerate and resolution
    • ZoneMinder Source Type

PROVIDING LOGFILE INFORMATION

It is often necessary to provide information from the ZoneMinder log files. Please follow these rules when providing this information:

  • Copy and paste the whole line, including the time and the component, without deleting any information.
  • Don't format it in any way. We are not going for style.
  • Please do not cherry pick what you believe to be the only relevant information. It is often helpful to know what is going on before and just after a particular error occurs.
  • More is better. Create a Gist or pastebin if necessary and link to that.
  • Camera RTSP issues are a real pain. We need a Level 5 debug session that shows the entire RTSP handshake, beginning with OPTIONS and ending with TEARDOWN (or the error if it did not make it that far). See the RTSP Wiki for more details.