Philip Olson wrote:
Hello everyone-
A few days ago Salah Faya introduced an online DocBook editing tool to
phpdoc-ar here:
http://news.php.net/php.doc.ar/758
We briefly talked about the possibility of having this work with all of
phpdoc-all so let's discuss that now. Currently it's suited for new
pages (no revcheck capabilities...) but Salah has some plans for that
and is eager to hear ideas. Have a look and discuss what you think about
this tool and how it can be implemented.
A few random thoughts to help get us started:
- docs.php.net or doc.php.net or ...
- how to manage the patch queue
- how to implement revcheck capabilities
- will we ever integrate 'cvs commit' directly
- how will the 'edit this' option be presented to users
- can we alter our html to better help this tool... like ids per block
- cvs location of this tool
- ...
In the past we've brought up the idea of having such a tool but never
implemented it... well it's happening now so let's do this. As soon as
we figure out where it'll of course be in CVS for people to play with.
Regards,
Philip
Well, IMO what's most important here is, assuming this is open to
everyone, not just people with doc-karma, to keep it moderated. So eg.
all patches get sent to the appropriate mailinglist, and can be
blocked/added there. It's imporant to do so, since most people don't
bother reading about coding styles, about styles of writing (in first
person, third person, etc.), and such. So, a bit of moderation there is
important I think.
- Tul
