What is the current status of livedocs development?

Accepting patches (applied mostly by Ilia and Wez).

There are several outstanding issues with the livedocs code. As I said
in my post, last night, HEAD seems broken. Also, Nuno has a number of
patches available at http://livedocs.aborla.net/

It would be nice if Ilia (and/or Wez) could review these patches, and apply / comment on them.


My point? I'd like to determine the proper procedure for patching
(getting patches approved for) livedocs, or find an alternative
development method.

I realize that livedocs is not ready for production, as it is intended.
It is, however VERY useful for doc team members (see Philip's posts re:
CHANGELOG and the EXIF changes he made for a practical example).

I also understand that the original authors of livedocs don't want their
code messed with. Isn't this the beauty of CVS, though?

I suspect this idea won't be well-received, but if we're not
willing/able to keep livedocs HEAD up to date, could we not branch the
module for testing purposes? Karma could be re-granted on a per-case
basis, with the condition that non-core developers do not commit to
HEAD, but to the dev branch. My understanding of the "staleness" of
livedocs is that Ilia and Wez are busy on PHP 5. I understand this.
People like Nuno, though, have demonstrated a knowledge of livedocs
code, and should be able to contribute, IMHO. I'd also like to see
livedocs tagged regularly so we can easily "rollback" to a previous
version (last night, while getting livedocs running, and failing
miserably, I was tempted to start pulling random dates out for cvs up -D ).

I'm not trying to point fingers, here, I'd just like to see livedocs
move forward. Can we find a way to make this happen?

All this is actually up to livedocs core developers (Ilia, Wez, Derick). BTW Derick offered a setup of livedocs to go for live testing at docs.php.net for this week.


Goba

Reply via email to