1
0
mirror of https://github.com/netbox-community/netbox.git synced 2024-05-10 07:54:54 +00:00

32 lines
2.8 KiB
Markdown
Raw Normal View History

2018-07-27 13:42:18 -04:00
# NetBox Development
NetBox is maintained as a [GitHub project](https://github.com/netbox-community/netbox) under the Apache 2 license. Users are encouraged to submit GitHub issues for feature requests and bug reports, however we are very selective about pull requests. Please see the `CONTRIBUTING` guide for more direction on contributing to NetBox.
2018-07-27 13:42:18 -04:00
2018-08-01 12:38:57 -04:00
## Communication
There are several official forums for communication among the developers and community members:
2018-08-01 12:38:57 -04:00
* [GitHub issues](https://github.com/netbox-community/netbox/issues) - All feature requests, bug reports, and other substantial changes to the code base **must** be documented in an issue.
* [GitHub Discussions](https://github.com/netbox-community/netbox/discussions) - The preferred forum for general discussion and support issues. Ideal for shaping a feature request prior to submitting an issue.
2021-06-14 16:41:10 -04:00
* [#netbox on NetDev Community Slack](https://netdev.chat/) - Good for quick chats. Avoid any discussion that might need to be referenced later on, as the chat history is not retained long.
* [Google Group](https://groups.google.com/g/netbox-discuss) - Legacy mailing list; slowly being phased out in favor of GitHub discussions.
2018-08-01 12:38:57 -04:00
## Governance
2018-07-27 13:42:18 -04:00
2018-08-01 12:38:57 -04:00
NetBox follows the [benevolent dictator](http://oss-watch.ac.uk/resources/benevolentdictatorgovernancemodel) model of governance, with [Jeremy Stretch](https://github.com/jeremystretch) ultimately responsible for all changes to the code base. While community contributions are welcomed and encouraged, the lead maintainer's primary role is to ensure the project's long-term maintainability and continued focus on its primary functions (in other words, avoid scope creep).
## Project Structure
All development of the current NetBox release occurs in the `develop` branch; releases are packaged from the `master` branch. The `master` branch should _always_ represent the current stable release in its entirety, such that installing NetBox by either downloading a packaged release or cloning the `master` branch provides the same code base.
2018-07-17 17:23:10 -04:00
2020-11-18 10:07:39 -05:00
NetBox components are arranged into functional subsections called _apps_ (a carryover from Django vernacular). Each app holds the models, views, and templates relevant to a particular function:
2018-07-17 17:23:10 -04:00
* `circuits`: Communications circuits and providers (not to be confused with power circuits)
* `dcim`: Datacenter infrastructure management (sites, racks, and devices)
2018-07-27 13:42:18 -04:00
* `extras`: Additional features not considered part of the core data model
2018-07-17 17:23:10 -04:00
* `ipam`: IP address management (VRFs, prefixes, IP addresses, and VLANs)
* `tenancy`: Tenants (such as customers) to which NetBox objects may be assigned
2020-11-18 10:07:39 -05:00
* `users`: Authentication and user preferences
2018-07-27 13:42:18 -04:00
* `utilities`: Resources which are not user-facing (extendable classes, etc.)
2018-07-17 17:23:10 -04:00
* `virtualization`: Virtual machines and clusters