remove references to GNATS from dev-model book

[jgh]

Summary

This also sync's with the official administrative roles for Bugmeister, as the GNATS Administrator was removed. Old description still applied, but was taken over by Bugmeister.

I also chose to use Bugzilla in the diff, as other software packages were mentioned, as well, so it seemed appropriate in this case. I would prefer to use "Problem Report database" where it makes sense.

[wblock]

en_US.ISO8859-1/books/dev-model/book.xml

1759

Is send-pr still recommended? Does it even work on all supported releases?

2057

Needs a serial comma.

2080

s/have also/also have/

2081

"available" is not needed at all.

[gavin]

en_US.ISO8859-1/books/dev-model/book.xml

1759

send-pr is still supported on all releases that shipped before we switched to Bugzilla. i.e. it is supported in all supported releases right now, except for 9.3 which shipped after the changeover.

We probably should not be recommending its use any more, however.

[remko]

First part: This is not true perse, newer versions do not come with send-pr nor should it be used. Can we mention that bugs should be filed through the webinterface?

Second part: lines 69/70: I do not see why these should be changed.

[remko]

Why is the bugmeister part removed btw? the team does the same with now Bugzilla instead of Gnats. I do not see why this is removed.

I also think we should talk about The Bugmeisters are responsible..

(How do I comment per line so that it's easier to track what I am talking about?)

[jgh]

In D1059#7, @remkolodder wrote:

First part: This is not true perse, newer versions do not come with send-pr nor should it be used. Can we mention that bugs should be filed through the webinterface?

That is a good idea. I will work this into the the next update.

Second part: lines 69/70: I do not see why these should be changed.

I don't see which lines these are, as there seems to not be any line changed with that number in this diff. Can you please quote what was changed?

en_US.ISO8859-1/books/dev-model/book.xml

2057

So you want it to read like this:
Perforce, Bugzilla, Mailman, and OpenSSH

If this is the case, I shall put it this way, however I strongly disagree. If this isn't the case, I'm not clear in what you are requesting to have done.

[jgh]

In D1059#8, @remkolodder wrote:

Why is the bugmeister part removed btw? the team does the same with now Bugzilla instead of Gnats. I do not see why this is removed.

I also think we should talk about The Bugmeisters are responsible..

(How do I comment per line so that it's easier to track what I am talking about?)

This is in-line, or I believe it is a proper representation of what the change was aiming to do, with what gavin@ (and was suggested by gavin@) had made to htdocs/administration.xml. If my interpretation was incorrect, I can address that. Gavin?

[helfman@its-jhelfman03 ~/workspace/doc/en_US.ISO8859-1/htdocs]$ svn diff -r45352:45450 administration.xml

Index: administration.xml

• administration.xml (revision 45352)

+++ administration.xml (revision 45450)
@@ -58,8 +58,7 @@

<ul>
 <li><a href="#t-accounts">Accounts Team</a></li>
 <li><a href="#t-backups">Backup Administrators</a></li>

• <li><a href="#t-bugmeister">Bugmeisters &amp; GNATS
• Administrators</a></li>

+ <li><a href="#t-bugmeister">Bugmeisters</a></li>

<li><a href="#t-clusteradm">Cluster Administrators</a></li>
<li><a href="#t-dnsadm">DNS Administrators</a></li>
<li><a href="#t-mirror-admin">FTP/WWW Mirror Site

@@ -338,10 +337,10 @@

  <li>&a.dhw.email;</li>
</ul>

• <h3><a name="t-bugmeister">Bugmeisters &amp; GNATS Administrators</a>

+ <h3><a name="t-bugmeister">Bugmeisters</a>

&lt;<a href="mailto:[e-mail]">[e-mail]</a>&gt;</h3>

• <p>The Bugmeisters and GNATS Administrators are responsible for ensuring

+ <p>The Bugmeisters are responsible for ensuring

that the maintenance database is in working order, that the entries are
correctly categorised and that there are no invalid entries.  They are
also responsible for the problem report group.</p>

[wblock]

en_US.ISO8859-1/books/dev-model/book.xml

39

<quote> seems wrong here. <command> or &man.send-pr.n; would be more appropriate, except that newer versions do not have it.

40

This line needs a serial comma.

[wblock]

en_US.ISO8859-1/books/dev-model/book.xml

39

Still not sure about send-pr. Maybe "Before &os;&nbsp;10, &os; included <command>send-pr</command>..."

And then use <command> tags when it is mentioned again in the next sentence.

43

s/our/the/ seems better.

[wblock]

Please build-test before commit.

[jgh]

Closed by commit rD45935 (authored by @jgh).