|
@@ -1,39 +1,52 @@
|
|
|
-# Contributing to NetBox
|
|
|
+## Getting Help
|
|
|
|
|
|
-Thank you for your interest in contributing to NetBox! This document contains some quick pointers on reporting bugs and
|
|
|
-requesting new features.
|
|
|
+If you encounter any issues installing or using NetBox, try one of the following resources to get assistance. Please
|
|
|
+**do not** open an issue on GitHub except to report bugs or request features.
|
|
|
|
|
|
-## Reporting Issues
|
|
|
+### Freenode IRC
|
|
|
|
|
|
-* First, ensure that you've installed the latest stable version of NetBox. If you're running an older version, it's
|
|
|
-possible that the bug has already been fixed.
|
|
|
+Join the #netbox channel on [Freenode IRC](https://freenode.net/). You can connect to Freenode at irc.freenode.net using
|
|
|
+an IRC client, or you can use their [webchat client](https://webchat.freenode.net/).
|
|
|
|
|
|
-* Check the [issues list](https://github.com/digitalocean/netbox/issues) to see if the bug you've found has already been
|
|
|
-reported. If you think you may be experiencing a reported issue, please add a quick comment to it with a "+1" and a
|
|
|
-quick description of how it's affecting your installation.
|
|
|
+### Reddit
|
|
|
|
|
|
-* If you're having trouble installing NetBox, please join #netbox on irc.freenode.net and ask for help before creating
|
|
|
-an issue on GitHub. Many installation problems are simple fixes. The issues list should be reserved for bug reports and
|
|
|
-feature requests.
|
|
|
+We have established [/r/netbox](https://www.reddit.com/r/netbox) on Reddit for NetBox issues and general discussion.
|
|
|
+Reddit registration is free and does not require providing an email address (although it is encouraged).
|
|
|
|
|
|
-* When submitting an issue, please be as descriptive as possible. Be sure to describe:
|
|
|
+## Reporting Bugs
|
|
|
+
|
|
|
+* First, ensure that you've installed the [latest stable version](https://github.com/digitalocean/netbox/releases) of
|
|
|
+NetBox. If you're running an older version, it's possible that the bug has already been fixed.
|
|
|
+
|
|
|
+* Next, check the GitHub [issues list](https://github.com/digitalocean/netbox/issues) to see if the bug you've found has
|
|
|
+already been reported. If you think you may be experiencing a reported issue that hasn't already been resolved, please
|
|
|
+click "add a reaction" in the top right corner of the issue and add a thumbs up (+1). You might also want to add a
|
|
|
+comment describing how it's affecting your installation. This will allow us to prioritize bugs based on how many users
|
|
|
+are affected.
|
|
|
+
|
|
|
+* If you haven't found an existing issue that describes your suspected bug, please inquire about it on IRC or Reddit.
|
|
|
+**Do not** file an issue until you have received confirmation that it is in fact a bug. Invalid issues are very
|
|
|
+distracting and slow the pace at which NetBox is developed.
|
|
|
+
|
|
|
+* When submitting an issue, please be as descriptive as possible. Be sure to include:
|
|
|
|
|
|
* The environment in which NetBox is running
|
|
|
* The exact steps that can be taken to reproduce the issue (if applicable)
|
|
|
* Any error messages returned
|
|
|
+ * Screenshots (if applicable)
|
|
|
|
|
|
* Keep in mind that we prioritize bugs based on their severity and how much work is required to resolve them. It may
|
|
|
-take some time for someone to address your issue. If it's been longer than a week with no updates, please ping us on
|
|
|
-IRC.
|
|
|
+take some time for someone to address your issue.
|
|
|
|
|
|
## Feature Requests
|
|
|
|
|
|
-* First, check the [issues list](https://github.com/digitalocean/netbox/issues) to see if the feature you're requesting
|
|
|
-has already been requested (and possibly rejected). If it has, click "add a reaction" in the top right corner of the
|
|
|
-issue and add a thumbs up (+1). This ensures that the issue has a better chance of making it onto the roadmap. Also feel
|
|
|
-free to add a comment with any additional justification for the feature.
|
|
|
+* First, check the GitHub [issues list](https://github.com/digitalocean/netbox/issues) to see if the feature you're
|
|
|
+requesting is already listed. (Be sure to search closed issues as well, since some feature requests are rejected.) If
|
|
|
+the feature you'd like to see has already been requested, click "add a reaction" in the top right corner of the issue
|
|
|
+and add a thumbs up (+1). This ensures that the issue has a better chance of making it onto the roadmap. Also feel free
|
|
|
+to add a comment with any additional justification for the feature.
|
|
|
|
|
|
-* While discussion of new features is welcome, it's important to limit the scope of NetBox's feature set to avoid
|
|
|
+* While suggestions for new features are welcome, it's important to limit the scope of NetBox's feature set to avoid
|
|
|
feature creep. For example, the following features would be firmly out of scope for NetBox:
|
|
|
|
|
|
* Ticket management
|
|
@@ -41,17 +54,18 @@ feature creep. For example, the following features would be firmly out of scope
|
|
|
* Acting as a DNS server
|
|
|
* Acting as an authentication server
|
|
|
|
|
|
-* Feature requests must be very narrowly defined. The more effort you put into writing a feature request, the better its
|
|
|
-chances are of being implemented. Overly broad feature requests will be closed.
|
|
|
+* Before filing a new feature request, propose it on IRC or Reddit first. Feedback you receive there will help validate
|
|
|
+and shape the proposed feature before filing a formal issue.
|
|
|
|
|
|
-* If you're not sure whether the feature you want is a good fit for NetBox, please ask in #netbox on irc.freenode.net.
|
|
|
-Even if it's not quite right for NetBox, we may be able to point you to a tool better suited for the job.
|
|
|
+* Good feature requests are very narrowly defined. Be sure to enumerate specific functionality and data schema. The more
|
|
|
+effort you put into writing a feature request, the better its chances are of being implemented. Overly broad feature
|
|
|
+requests will be closed.
|
|
|
|
|
|
-* When submitting a feature request, be sure to include the following:
|
|
|
+* When submitting a feature request on GitHub, be sure to include the following:
|
|
|
|
|
|
- * A detailed description of the functionality
|
|
|
+ * A detailed description of the proposed functionality
|
|
|
* A use case for the feature; who would use it and what value it would add to NetBox
|
|
|
- * A rough description of any changes necessary to the database schema (if applicable)
|
|
|
+ * A rough description of any changes necessary to the database schema
|
|
|
* Any third-party libraries or other resources which would be involved
|
|
|
|
|
|
## Submitting Pull Requests
|
|
@@ -60,9 +74,8 @@ Even if it's not quite right for NetBox, we may be able to point you to a tool b
|
|
|
before beginning work. This will help prevent wasting time on something that might we might not be able to implement.
|
|
|
When suggesting a new feature, also make sure it won't conflict with any work that's already in progress.
|
|
|
|
|
|
-* When submitting a pull request, please be sure to work off of branch `develop`, rather than branch `master`.
|
|
|
-In NetBox, the `develop` branch is used for ongoing development, while `master` is used for tagging new
|
|
|
-stable releases.
|
|
|
+* When submitting a pull request, please be sure to work off of the `develop` branch, rather than `master`. In NetBox,
|
|
|
+the `develop` branch is used for ongoing development, while `master` is used for tagging new stable releases.
|
|
|
|
|
|
* All code submissions should meet the following criteria (CI will enforce these checks):
|
|
|
|