125978 - Remove process documentation (Hackers' Guide) from Bugzilla Guide.

Status: RESOLVED FIXED

(Bugzilla :: Documentation, defect, P1)

Description

[Matthew Tuck [:CodeMachine]]

Process documentation (bug #125975) is continually updated to reflect the
changes in Bugzilla.  I suggest people should be encouraged to look at this
online (on the web site somewhere), and not in their tarballs which can be out
of date.

Currently, the only process documentation I know of is the Hackers' Guide.  This
is a part of the Bugzilla Guide, but I think it shouldn't be.  Instead, I think
it should be moved to a new process documentation section on the web site which
can be kept up to date.

There seemed to be approval of this from the small number of people polled on
IRC, but of course we'll see what barnboy has to say about this.

Barnboy would continue to look after the Hackers' Guide if he wished.  Or
instead, I would be willing to deal with all process documentation if it was
determined to be a good idea.

Comment 1

[Matthew Tuck [:CodeMachine]]

The current section would become a brief description including a link.

Comment 2

[Matthew Barnson]

I'd rather leave the Hacker's Guide in the hands of the hackers, not the
documentors.  Pulling it out of the Guide and into something which is updated
more regularly, IMHO, is a good thing.

Comment 3

[Matthew Tuck [:CodeMachine]]

Also FAQ section 11, especially A.11.3 seems out of date.  The new developers'
guide documentation will be arriving on the web site shortly.

Comment 4

[Dave Miller [:justdave]]

Barnboy changed his email address and opened a new account instead of having the
address changed on his existing one.  Reassigning all docs bugs to his new account.

Comment 5

[Matthew Tuck [:CodeMachine]]

Said documentation has arrived - we need to get this updated.

Comment 6

[Gervase Markham [:gerv]]

The fix for this is to nuke section D.5 of the guide?

Gerv

Comment 7

[Gervase Markham [:gerv]]

D.5 nuked and FAQ overhauled.

Gerv