summaryrefslogtreecommitdiffstats
path: root/web/input/development.md
diff options
context:
space:
mode:
Diffstat (limited to 'web/input/development.md')
-rw-r--r--web/input/development.md60
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 @@
1title: Development
2parent: Home
3menu-position: 5
4---
5
6# Development
7
8## Software Repositories
9
10The [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
16These projects are maintained in separate repositories on [GitHub][github]:
17
18* <https://github.com/nagios-plugins/repositories>
19
20Contributions are always welcome! If you'd like to provide patches, please
21[fork][fork] the desired repository and submit a [pull request][pull]. In
22case you're not familiar with Git, you might want to look into [Scott
23Chacon][scott]'s [Pro Git][book] book available on the [Git web site][git]
24first.
25
26## Development Guidelines
27
28Apart from the actual code, the [team][team] also maintains the official
29[Nagios Plugin Development Guidelines][guidelines]. If you plan on
30contributing to the standard plugins package, or writing your own checks, you
31should read them!
32
33## Test Suite
34
35The Nagios Plugins bundle comes with an extensive test suite. Some of the
36tests require [libtap][libtap], a copy of which is shipped with the Nagios
37Plugins source tarball. In order to execute all tests, issue the following
38commands:
39
40 $ ./tools/setup # When building from Git.
41 $ ./configure --enable-libtap
42 $ make
43 $ make test
44
45Regular tests of the latest code are scheduled automatically on various
46platforms, 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: # %-->