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: # %--> | ||