summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/LEAVERS9
-rw-r--r--doc/NEW_STARTERS15
-rw-r--r--doc/RELEASING15
-rw-r--r--doc/developer-guidelines.sgml59
4 files changed, 44 insertions, 54 deletions
diff --git a/doc/LEAVERS b/doc/LEAVERS
index 13382c9..a52a600 100644
--- a/doc/LEAVERS
+++ b/doc/LEAVERS
@@ -3,13 +3,12 @@ LEAVERS
3These are the steps for someone leaving the team. 3These are the steps for someone leaving the team.
4 4
5Leaver has to: 5Leaver has to:
6 - Update all current tracker items 6 - Update all current issues on GitHub
7 7
8Administration tasks: 8Administration tasks:
9 - Reassign leaver's tracker items to project lead 9 - Reassign leaver's tracker items to project lead
10 - Remove from Sourceforge's list of developers. This will include CVS access. Do not 10 - Remove from GitHub's project members. This will include Git access.
11 need to remove from CVS avail file 11 - Remove access from project server
12 - Remove access from repos.or.cz for all three Git repositories
13 - If applicable, remove from mailing list administrators 12 - If applicable, remove from mailing list administrators
14 - Keep on nagiosplug-team mailing list, unless specifically requested to be removed 13 - Keep on team mailing list, unless specifically requested to be removed
15 14
diff --git a/doc/NEW_STARTERS b/doc/NEW_STARTERS
index 6247c82..2c5aac8 100644
--- a/doc/NEW_STARTERS
+++ b/doc/NEW_STARTERS
@@ -4,12 +4,12 @@ These are the steps for adding someone to the team.
4 4
5Need to know: 5Need to know:
6 - Name 6 - Name
7 - Primary email for nagiosplug-team mailings 7 - Primary email for team mailings
8 - Sourceforge id 8 - GitHub account
9 - Type of member (translator, developer, release manager, project administrator) 9 - Type of member (translator, developer, release manager, project administrator)
10 10
111. Add member to nagiosplug-team mailing list (https://lists.sourceforge.net/lists/admin/nagiosplug-team) 111. Add member to team mailing list (https://www.monitoring-plugins.org/list/listinfo/team/)
12 and to the nagiosplug-checkins mailing list (https://lists.sourceforge.net/lists/admin/nagiosplug-checkins, 12 and to the commits mailing list (https://www.monitoring-plugins.org/list/listinfo/commits/),
13 add sourceforge email address via Privacy Options->Sender filters) 13 add sourceforge email address via Privacy Options->Sender filters)
142. Add Sourceforge access: 142. Add Sourceforge access:
15 - Translator: CVS access, Shell access, Release Tech (no) 15 - Translator: CVS access, Shell access, Release Tech (no)
@@ -18,8 +18,7 @@ Need to know:
18 Update Developer Permissions. 18 Update Developer Permissions.
19 For each tracker, set to Technician (need to add all trackers first, then change to 19 For each tracker, set to Technician (need to add all trackers first, then change to
20 technician for each one) 20 technician for each one)
213. Add to CVS avail file: 213. Create account on project server
22 - Translator: Add member to translation files 22 - Add public ssh keys
23 - Developer: Add member to CVSROOT/avail for all files
244. Add Git access on repos.or.cz 234. Add Git access on repos.or.cz
255. Send email to nagiosplug-team introducing new member 245. Send email to team introducing new member
diff --git a/doc/RELEASING b/doc/RELEASING
index 34bed93..1eaec9d 100644
--- a/doc/RELEASING
+++ b/doc/RELEASING
@@ -1,8 +1,5 @@
1NOTES ON RELEASING NEW VERSION OF NAGIOSPLUG 1NOTES ON RELEASING NEW VERSION OF NAGIOSPLUG
2 2
3NB: A copy of this document is located at:
4 http://nagiosplugins.org/node/96
5
6*** Pre-release 3*** Pre-release
7git pull 4git pull
8. tools/devmode, if feeling adventurous 5. tools/devmode, if feeling adventurous
@@ -24,15 +21,15 @@ git push origin master
24git push origin release-1.4.14 21git push origin release-1.4.14
25 22
26*** Checkout new version 23*** Checkout new version
27rm -fr /tmp/nagioslug 24rm -fr /tmp/monitoringlug
28# If you need to checkout the tag, don't forget to "checkout master" later to 25# If you need to checkout the tag, don't forget to "checkout master" later to
29# get back to your development branch: 26# get back to your development branch:
30git checkout tags/release-1.4.14 27git checkout tags/release-1.4.14
31# Beware: the trailing slash of --prefix is REQUIRED 28# Beware: the trailing slash of --prefix is REQUIRED
32git checkout-index --prefix=/tmp/nagioslug/ -a 29git checkout-index --prefix=/tmp/monitoringlug/ -a
33 30
34*** Build the tarball 31*** Build the tarball
35cd /tmp/nagioslug 32cd /tmp/monitoringlug
36tools/setup 33tools/setup
37./configure 34./configure
38make dist 35make dist
@@ -43,7 +40,7 @@ SF username and password
43cd /uploads 40cd /uploads
44put file 41put file
45 42
46SF -> Submit News about release. Make sure it is called "Nagios Plugins" (with those caps) 43SF -> Submit News about release. Make sure it is called "Monitoring Plugins" (with those caps)
47Link to download at http://sourceforge.net/project/showfiles.php?group_id=29880 44Link to download at http://sourceforge.net/project/showfiles.php?group_id=29880
48Include contents of NEWS for this release 45Include contents of NEWS for this release
49List all people on team involved. 46List all people on team involved.
@@ -60,5 +57,5 @@ Step 3: *.tar.gz, Platform Independent, Source .gz
60Step 4: Send notice 57Step 4: Send notice
61 58
62*** Announce new release 59*** Announce new release
63Send email to nagiosplug-help, nagios-announce with the news text 60Send email to help, announce with the news text
64Add a news item to http://nagiosplugins.org 61Add a news item to https://monitoring-plugins.org
diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index 61b9f17..d934028 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -1,18 +1,18 @@
1<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" > 1<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" >
2<book> 2<book>
3 <title>Nagios Plugin Development Guidelines</title> 3 <title>Monitoring Plugins Development Guidelines</title>
4 4
5 <bookinfo> 5 <bookinfo>
6 <authorgroup> 6 <authorgroup>
7 <author> 7 <author>
8 <affiliation> 8 <affiliation>
9 <orgname>Nagios Plugins Development Team</orgname> 9 <orgname>Monitoring Plugins Development Team</orgname>
10 </affiliation> 10 </affiliation>
11 </author> 11 </author>
12 </authorgroup> 12 </authorgroup>
13 13
14 <pubdate>2013</pubdate> 14 <pubdate>2013</pubdate>
15 <title>Nagios Plugin Development Guidelines</title> 15 <title>Monitoring Plugins Development Guidelines</title>
16 16
17 <revhistory> 17 <revhistory>
18 <revision> 18 <revision>
@@ -23,7 +23,7 @@
23 23
24 <copyright> 24 <copyright>
25 <year>2000 - 2013</year> 25 <year>2000 - 2013</year>
26 <holder>Nagios Plugins Development Team</holder> 26 <holder>Monitoring Plugins Development Team</holder>
27 </copyright> 27 </copyright>
28 28
29</bookinfo> 29</bookinfo>
@@ -34,8 +34,8 @@
34 the plugin developers and encourage the standarization of the 34 the plugin developers and encourage the standarization of the
35 different kind of plugins: C, shell, perl, python, etc.</para> 35 different kind of plugins: C, shell, perl, python, etc.</para>
36 36
37 <para>Nagios Plugin Development Guidelines Copyright (C) 2000-2013 37 <para>Monitoring Plugins Development Guidelines Copyright (C) 2000-2013
38 (Nagios Plugins Team)</para> 38 (Monitoring Plugins Team)</para>
39 39
40 <para>Permission is granted to make and distribute verbatim 40 <para>Permission is granted to make and distribute verbatim
41 copies of this manual provided the copyright notice and this 41 copies of this manual provided the copyright notice and this
@@ -48,8 +48,8 @@
48<article> 48<article>
49<section id="DevRequirements"><title>Development platform requirements</title> 49<section id="DevRequirements"><title>Development platform requirements</title>
50 <para> 50 <para>
51 Nagios Plugins are developed to the GNU standard, so any OS which is supported by GNU 51 Monitoring Plugins are developed to the GNU standard, so any OS which is supported by GNU
52 should run the plugins. While the requirements for compiling the Nagios Plugins release 52 should run the plugins. While the requirements for compiling the Monitoring Plugins release
53 are very basic, developing from the Git repository requires additional software to be 53 are very basic, developing from the Git repository requires additional software to be
54 installed. These are the minimum levels of software required: 54 installed. These are the minimum levels of software required:
55 55
@@ -152,7 +152,7 @@
152 <section><title>Plugin Return Codes</title> 152 <section><title>Plugin Return Codes</title>
153 <para>The return codes below are based on the POSIX spec of returning 153 <para>The return codes below are based on the POSIX spec of returning
154 a positive value. Netsaint prior to v0.0.7 supported non-POSIX 154 a positive value. Netsaint prior to v0.0.7 supported non-POSIX
155 compliant return code of "-1" for unknown. Nagios supports POSIX return 155 compliant return code of "-1" for unknown. Nagios supports POSIX return
156 codes by default.</para> 156 codes by default.</para>
157 157
158 <para>Note: Some plugins will on occasion print on STDOUT that an error 158 <para>Note: Some plugins will on occasion print on STDOUT that an error
@@ -379,7 +379,7 @@
379 </listitem> 379 </listitem>
380 </orderedlist> 380 </orderedlist>
381 381
382 <para>It is up to third party programs to convert the Nagios Plugins 382 <para>It is up to third party programs to convert the Monitoring Plugins
383 performance data into graphs.</para> 383 performance data into graphs.</para>
384 </section> 384 </section>
385 385
@@ -678,11 +678,6 @@ To run a test, from the top level directory, run "make test". This will run
678all the current tests and report an overall success rate. 678all the current tests and report an overall success rate.
679</para> 679</para>
680 680
681<para>
682See the <ulink url="http://tinderbox.opsera.com">Nagios Plugins Tinderbox server</ulink>
683for the daily test results.
684</para>
685
686<section><title>Test cases for plugins</title> 681<section><title>Test cases for plugins</title>
687<para>These use perl's Test::More. To do a one time test, run "cd plugins && perl t/check_disk.t". 682<para>These use perl's Test::More. To do a one time test, run "cd plugins && perl t/check_disk.t".
688</para> 683</para>
@@ -699,7 +694,7 @@ This runs the test in a summary format.
699 694
700<para> 695<para>
701For a good and amusing tutorial on using Test::More, see this 696For a good and amusing tutorial on using Test::More, see this
702<ulink url="http://search.cpan.org/~mschwern/Test-Simple-0.62/lib/Test/Tutorial.pod"> 697<ulink url="http://search.cpan.org/dist/Test-Simple/lib/Test/Tutorial.pod">
703link</ulink> 698link</ulink>
704</para> 699</para>
705 700
@@ -720,7 +715,7 @@ properly on non-FreeBSD systems. Install with 'CPPFLAGS="-UHAVE_LIBPTHREAD" ./co
720</para> 715</para>
721 716
722<para> 717<para>
723When you run Nagios Plugins' configure, it will look for the tap library and will automatically 718When you run Monitoring Plugins' configure, it will look for the tap library and will automatically
724setup the tests. Run "make test" to run all the tests. 719setup the tests. Run "make test" to run all the tests.
725</para> 720</para>
726</section> 721</section>
@@ -752,9 +747,9 @@ setup the tests. Run "make test" to run all the tests.
752 </section> 747 </section>
753 748
754 <section><title>Commit Messages</title> 749 <section><title>Commit Messages</title>
755 <para>If the change is due to a contribution, please quote the contributor's name 750 <para>If the change is due to a contribution, please quote the contributor's name
756 and, if applicable, add the SourceForge Tracker number. Don't forget to 751 and, if applicable, add the GitHub Issue Tracker number. Don't forget to
757update the THANKS.in file.</para> 752 update the THANKS.in file.</para>
758 <para>If you have a change that is useful for noting in the next release, please 753 <para>If you have a change that is useful for noting in the next release, please
759 update the NEWS file.</para> 754 update the NEWS file.</para>
760 <para>All commits will be written to a ChangeLog at release time. 755 <para>All commits will be written to a ChangeLog at release time.
@@ -765,7 +760,7 @@ update the THANKS.in file.</para>
765 <para>To make the job easier for translators, please follow these guidelines:</para> 760 <para>To make the job easier for translators, please follow these guidelines:</para>
766 <orderedlist> 761 <orderedlist>
767 <listitem><para> 762 <listitem><para>
768 Before creating new strings, check the po/nagios-plugins.pot file to 763 Before creating new strings, check the po/monitoring-plugins.pot file to
769 see if a similar string 764 see if a similar string
770 already exists 765 already exists
771 </para></listitem> 766 </para></listitem>
@@ -795,15 +790,15 @@ update the THANKS.in file.</para>
795 version you are using. For new features, please supply a diff against 790 version you are using. For new features, please supply a diff against
796 the Git "master" branch.</para> 791 the Git "master" branch.</para>
797 792
798 <para>Patches should be submitted via 793 <para>Patches should be submitted via
799 <ulink url="http://sourceforge.net/tracker/?group_id=29880&amp;atid=397599">SourceForge's 794 <ulink url="https://github.com/monitoring-plugins/monitoring-plugins/pulls">GitHub's
800 tracker system for Nagiosplug patches</ulink> 795 Pull requests for Monitoring Plugins</ulink>
801 and be announced to the nagiosplug-devel mailing list.</para> 796 </para>
802 797
803 <para>Submission of a patch implies that the submmitter acknowledges that they 798 <para>Submission of a patch implies that the submmitter acknowledges that they
804 are the author of the code (or have permission from the author to release the code) 799 are the author of the code (or have permission from the author to release the code)
805 and agree that the code can be released under the GPL. The copyright for the changes will 800 and agree that the code can be released under the GPL. The copyright for the changes will
806 then revert to the Nagios Plugin Development Team - this is required so that any copyright 801 then revert to the Monitoring Plugins Development Team - this is required so that any copyright
807 infringements can be investigated quickly without contacting a huge list of copyright holders. 802 infringements can be investigated quickly without contacting a huge list of copyright holders.
808 Credit will always be given for any patches through a THANKS file in the distribution.</para> 803 Credit will always be given for any patches through a THANKS file in the distribution.</para>
809 </section> 804 </section>
@@ -811,22 +806,22 @@ update the THANKS.in file.</para>
811 806
812 <section id="Contributedplugins"><title>Contributed plugins</title> 807 <section id="Contributedplugins"><title>Contributed plugins</title>
813 <para>Plugins that have been contributed to the project and 808 <para>Plugins that have been contributed to the project and
814 distributed with the Nagios Plugin files are held in the contrib/ directory and are not installed 809 distributed with the Monitoring Plugins files are held in the contrib/ directory and are not installed
815 by default. These plugins are not officially supported by the team. 810 by default. These plugins are not officially supported by the team.
816 The current policy is that these plugins should be owned and maintained by the original 811 The current policy is that these plugins should be owned and maintained by the original
817 contributor, preferably hosted on <ulink url="http://exchange.nagios.org">Nagios Exchange</ulink>. 812 contributor, preferably hosted on <ulink url="http://monitoringexchange.org">Monitoring Exchange</ulink>.
818 </para> 813 </para>
819 <para>If patches or bugs are raised to an contributed plugin, we will start communications with the 814 <para>If patches or bugs are raised to an contributed plugin, we will start communications with the
820 original contributor, but seek to remove the plugin from our distribution. 815 original contributor, but seek to remove the plugin from our distribution.
821 </para> 816 </para>
822 <para>The aim is to distribute only code that the Nagios Plugin team are responsible for. 817 <para>The aim is to distribute only code that the Monitoring Plugins team are responsible for.
823 </para> 818 </para>
824 </section> 819 </section>
825 820
826 <section id="Newplugins"><title>New plugins</title> 821 <section id="Newplugins"><title>New plugins</title>
827 <para>If you would like others to use your plugins, please add it to 822 <para>If you would like others to use your plugins, please add it to
828 the official 3rd party plugin repository, 823 the official 3rd party plugin repository,
829 <ulink url="http://exchange.nagios.org">Nagios Exchange</ulink>. 824 <ulink url="http://monitoringexchange.org">Monitoring Exchange</ulink>.
830 </para> 825 </para>
831 826
832 <para>We are not accepting requests for inclusion of plugins into 827 <para>We are not accepting requests for inclusion of plugins into
@@ -837,7 +832,7 @@ update the THANKS.in file.</para>
837 <orderedlist> 832 <orderedlist>
838 <listitem> 833 <listitem>
839 <para>Include copyright and license information in all files. Copyright must be solely 834 <para>Include copyright and license information in all files. Copyright must be solely
840 granted to the Nagios Plugin Development Team</para> 835 granted to the Monitoring Plugins Development Team</para>
841 </listitem> 836 </listitem>
842 <listitem> 837 <listitem>
843 <para>The standard command options are supported (--help, --version, 838 <para>The standard command options are supported (--help, --version,