diff options
Diffstat (limited to 'web/input/development.md')
| -rw-r--r-- | web/input/development.md | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/web/input/development.md b/web/input/development.md new file mode 100644 index 0000000..ddff634 --- /dev/null +++ b/web/input/development.md | |||
| @@ -0,0 +1,60 @@ | |||
| 1 | title: Development | ||
| 2 | parent: Home | ||
| 3 | menu-position: 5 | ||
| 4 | --- | ||
| 5 | |||
| 6 | # Development | ||
| 7 | |||
| 8 | ## Software Repositories | ||
| 9 | |||
| 10 | The [Nagios Plugins Development Team][team] takes care of three projects: | ||
| 11 | |||
| 12 | * Nagios Plugins — the core bundle of standard plugins. | ||
| 13 | * Nagios::Plugin — a module used by plugins written in Perl. | ||
| 14 | * NagiosMIB — SNMP MIB files for traps sent from [Nagios][nagios]. | ||
| 15 | |||
| 16 | These projects are maintained in separate repositories on [GitHub][github]: | ||
| 17 | |||
| 18 | * <https://github.com/nagios-plugins/repositories> | ||
| 19 | |||
| 20 | Contributions are always welcome! If you'd like to provide patches, please | ||
| 21 | [fork][fork] the desired repository and submit a [pull request][pull]. In | ||
| 22 | case you're not familiar with Git, you might want to look into [Scott | ||
| 23 | Chacon][scott]'s [Pro Git][book] book available on the [Git web site][git] | ||
| 24 | first. | ||
| 25 | |||
| 26 | ## Development Guidelines | ||
| 27 | |||
| 28 | Apart from the actual code, the [team][team] also maintains the official | ||
| 29 | [Nagios Plugin Development Guidelines][guidelines]. If you plan on | ||
| 30 | contributing to the standard plugins package, or writing your own checks, you | ||
| 31 | should read them! | ||
| 32 | |||
| 33 | ## Test Suite | ||
| 34 | |||
| 35 | The Nagios Plugins bundle comes with an extensive test suite. Some of the | ||
| 36 | tests require [libtap][libtap], a copy of which is shipped with the Nagios | ||
| 37 | Plugins source tarball. In order to execute all tests, issue the following | ||
| 38 | commands: | ||
| 39 | |||
| 40 | $ ./tools/setup # When building from Git. | ||
| 41 | $ ./configure --enable-libtap | ||
| 42 | $ make | ||
| 43 | $ make test | ||
| 44 | |||
| 45 | Regular tests of the latest code are scheduled automatically on various | ||
| 46 | platforms, the results can be [viewed online][tests]. | ||
| 47 | |||
| 48 | [team]: team.html "Nagios Plugins Development Team" | ||
| 49 | [nagios]: http://www.nagios.org/ "Nagios" | ||
| 50 | [github]: https://github.com/ "GitHub" | ||
| 51 | [fork]: https://help.github.com/articles/fork-a-repo "Fork Documentation" | ||
| 52 | [pull]: https://help.github.com/articles/using-pull-requests "Pull Request Documentation" | ||
| 53 | [scott]: http://scottchacon.com/ "Scott Chacon" | ||
| 54 | [book]: http://git-scm.com/book "Pro Git" | ||
| 55 | [git]: http://git-scm.com/ "Git" | ||
| 56 | [guidelines]: doc/guidelines.html "Nagios Plugin Development Guidelines" | ||
| 57 | [libtap]: http://jc.ngo.org.uk/trac-bin/trac.cgi/wiki/LibTap "LibTap Homepage" | ||
| 58 | [tests]: tests.html "Test Results" | ||
| 59 | |||
| 60 | <!--% # vim:set filetype=markdown textwidth=78 joinspaces: # %--> | ||
