[documentation] Proposal for handbook maintenance automation

Matt Kelly matthwk at gmail.com
Wed Aug 8 03:49:55 UTC 2007


As a newer handbook maintainer I find it hard to find items that need to 
be updated.  I end browsing around aimlessly or I only update content 
that I have found useful.

My idea for a page that displays a queue of handbook pages based on 
weight hopes too fix this problem.  The module would gather statistics 
including popularity (number of total page views, page views per day, 
etc) and age (time of last update), and then weight them based off of 
that combination.  Then, it would output the results in a page that 
other maintainers could view.  Obviously, the pages at the top would be 
the oldest and most popular.  This would at least show maintainers what 
pages may need to be updated.

Also, I think if a common user could flag a handbook as "needs updated", 
it would come in use.  Before I was a maintainer, I viewed handfuls of 
handbook pages that needed updated, but I didn't know who to notify.  It 
would be useful to have a link for "needs updated", or something 
similar, so that maintainers could be notified.  All flagged handbook 
pages would be compiled into a page, sorted by number of flags.

Thoughts?  Maybe I'm missing something that already solves these 
problems?  Let me know.

Thanks,
Matt


More information about the documentation mailing list