Newsgroups: php.doc,php.internals Path: news.php.net Xref: news.php.net php.doc:969379442 php.internals:40824 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 56363 invoked from network); 1 Oct 2008 18:03:35 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 1 Oct 2008 18:03:35 -0000 Authentication-Results: pb1.pair.com smtp.mail=stas@zend.com; spf=pass; sender-id=pass Authentication-Results: pb1.pair.com header.from=stas@zend.com; sender-id=pass Received-SPF: pass (pb1.pair.com: domain zend.com designates 212.25.124.163 as permitted sender) X-PHP-List-Original-Sender: stas@zend.com X-Host-Fingerprint: 212.25.124.163 il-gw1.zend.com Windows 2000 SP4, XP SP1 Received: from [212.25.124.163] ([212.25.124.163:28493] helo=il-gw1.zend.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 3B/4F-04812-67BB3E84 for ; Wed, 01 Oct 2008 14:03:35 -0400 Received: from us-ex1.zend.com ([192.168.16.5]) by il-gw1.zend.com with Microsoft SMTPSVC(6.0.3790.3959); Wed, 1 Oct 2008 21:03:42 +0300 Received: from [192.168.16.110] ([192.168.16.110]) by us-ex1.zend.com with Microsoft SMTPSVC(6.0.3790.3959); Wed, 1 Oct 2008 11:03:17 -0700 Message-ID: <48E3BB65.9040405@zend.com> Date: Wed, 01 Oct 2008 11:03:17 -0700 Organization: Zend Technologies User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: Elizabeth M Smith CC: phpdoc@lists.php.net, internals@lists.php.net References: <7f3ed2c30810010639q445b94b3m637ed929215d1cc6@mail.gmail.com> <49.5C.04812.F70B3E84@pb1.pair.com> In-Reply-To: <49.5C.04812.F70B3E84@pb1.pair.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-OriginalArrivalTime: 01 Oct 2008 18:03:17.0552 (UTC) FILETIME=[FB359B00:01C923EF] Subject: Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead? From: stas@zend.com (Stanislav Malyshev) Hi! > tools). Writing in XML is not a natural thing. An online interface > where people can edit docs would seriously boost people helping out. > Why do you think there are so many user notes in the PHP manual ;) I think a web-based tool that would allow to generate standard docbook pages (at least most primitive ones) and allow to edit certain sections while supporting some basic stuff like paragraphs, links, styles (italic, bold) etc. would be a HUGE help. I can write docbook and have experience with it and I still find it annoying and hard to remember all the details, I can only imagine how intimidating it appears to a newbie. Easy tool allowing to contribute (and see the result without having to install the whole toolchain?) would be an enormous boon. Of course, we'd have to review/approve contributions, not have everybody do what they please, but it's solvable. So here's an idea for next Google Code project or for anybody having free time :) -- Stanislav Malyshev, Zend Software Architect stas@zend.com http://www.zend.com/ (408)253-8829 MSN: stas@zend.com