151961 - RFE: Add tool for documentation's catalog on reviewing documentation

Status: RESOLVED WONTFIX

(mozilla.org :: Miscellaneous, task)

Description

[Alex Vincent [:WeirdAl]]

I have an idea for an enhancement to www.mozilla.org/catalog which places a
database underneath the catalog and allows us to track when a document was
reviewed for accuracy and what Bugzilla bug number applies to that bug.

This bug is for creating the database layer in the catalog.  The first phase of
this bug is for me to create a proposed MySQL database and PHP/XHTML scripts for
that database.  The second phase of this bug is for jkeiser to translate the PHP
scripts into Perl scripts for inclusion as a new tool for mozilla.org.

Comment 1

[Alex Vincent [:WeirdAl]]

Well, I've got a broken setup.  But hopefully it'll be a good starting point for
jkeiser.

http://jslab.org/mozcatalog/addPage.php.txt -- the script dies in the first
MySQL query.  Something is not working right.

http://jslab.org/mozcatalog/addPage.html -- for an HTML template (missing a
submit button)
http://jslab.org/mozcatalog/addPage.js -- the JavaScript
http://jslab.org/mozcatalog/mysql.php.txt -- for connecting to the MySQL db
(it's written for my machine, not yours)
http://jslab.org/mozcatalog/mozcatalog.mysql -- a MySQL query for creating the
database.

Comment 2

[Alex Vincent [:WeirdAl]]

Reassigning to jkeiser:  this has to be written in Perl, my insert query is
broken for reasons I don't understand, he's motivated and understands what needs
to be done.

Comment 3

[Alex Vincent [:WeirdAl]]

Okay, quick summary of a hot debate:

It seems better to track our documentation via Zope, except dawn is requiring
CVS blame tracking.  So our current consensus may be to hack Zope to log into
the CVS tree that Mozilla uses, and track our documentation through Zope, with
comments showing who's actually doing the changes via CVS.

Comment 4

[Alex Vincent [:WeirdAl]]

jkeiser thinks it would be easier and better to build cvs blame natively into
Zope.  Opinions?

Comment 5

[Alex Vincent [:WeirdAl]]

<irc:quote author="jkeiser">
Make Zope Work. runyaga is asking about the easiest way to do the cvs mirroring
we want, but given that there are existing CVS impls out there cvsblame should
not be a problem.

runyaga is going to set some things up on his server, and I'm going to test an
install of bonsai to see if I can get it to work. Hmm, mozwebtools would know
who knows how to set that up, maybe they could help.

The long and short of it--well the short anyway--is that we want to get cvs
blame up to keep existing functionality, and that Zope can do everything all of
us wants with existing Zope functionality, so we should Go There.
</irc:quote>

Comment 6

[Alex Vincent [:WeirdAl]]

jkeiser:  mind if I take this bug back from you? :) I've recently started 
reworking my PHP/MySQL approach to the catalog.  I currently have a script to 
dump the current catalog to a MySQL database, and I'm working on tools to 
maintain it and output the catalog (both in a static page set for those who 
won't be logging in, and in dynamic pages for those who do log in).

Comment 7

[Alex Vincent [:WeirdAl]]

w/ jkeiser's permission.

Comment 8

[Alex Vincent [:WeirdAl]]

Really reassigning.

Comment 9

[Dave Miller [:justdave]]

This isn't really a server ops bug.  There's nothing for ops to do until someone
has an app written and you need somewhere to install it.  Until such time this
is just tracking a generic project.

Comment 10

[Reed Loden [:reed]]

Updating QAContact of all Miscellaneous bugs to [e-mail]. If this particular bug should have a different QAContact, please change it and accept my apologies.

Comment 11

[Alex Vincent [:WeirdAl]]

This bug is dead, obsolete and buried.  ->WONTFIX.