Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:43010 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 30841 invoked from network); 11 Feb 2009 19:53:18 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 11 Feb 2009 19:53:18 -0000 Authentication-Results: pb1.pair.com smtp.mail=steph@php.net; spf=unknown; sender-id=unknown Authentication-Results: pb1.pair.com header.from=steph@php.net; sender-id=unknown Received-SPF: unknown (pb1.pair.com: domain php.net does not designate 64.99.136.184 as permitted sender) X-PHP-List-Original-Sender: steph@php.net X-Host-Fingerprint: 64.99.136.184 smtprelay-virgin0184.hostedemail.com Received: from [64.99.136.184] ([64.99.136.184:48436] helo=smtprelay-virgin.hostedemail.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 31/A6-12172-DAC23994 for ; Wed, 11 Feb 2009 14:53:17 -0500 Received: from filter.hostedemail.com (ff-bigip1 [10.5.19.254]) by smtprelay08.hostedemail.com (Postfix) with SMTP id F31E922E3AE9; Wed, 11 Feb 2009 19:53:14 +0000 (UTC) X-SpamScore: 1 X-Spam-Summary: 2,0,0,fd139da899160854,691ff1dea13fdf9b,steph@php.net,pierre.php@gmail.com:kenashkov@gmail.com:hannes.magnusson@gmail.com:mls@pooteeweet.org:internals@lists.php.net,RULES_HIT:355:379:539:540:541:542:543:567:599:601:968:988:989:1155:1156:1260:1277:1311:1313:1314:1345:1437:1515:1516:1518:1534:1540:1587:1593:1594:1711:1730:1747:1766:1792:2073:2075:2078:2393:2559:2562:2693:2828:3027:3352:3865:3866:3867:3868:3869:3870:3871:3872:3873:3874:3876:3877:4250:4470:5007:6114:6261:7653:7875:8501,0,RBL:none,CacheIP:none,Bayesian:0.5,0.5,0.5,Netcheck:none,DomainCache:0,MSF:not bulk,SPF:,MSBL:none,DNSBL:none Received: from foxbox (77-100-159-145.cable.ubr07.shef.blueyonder.co.uk [77.100.159.145]) (Authenticated sender: steph.fox) by omf11.hostedemail.com (Postfix) with ESMTP; Wed, 11 Feb 2009 19:53:10 +0000 (UTC) Message-ID: <00f501c98c82$b8c560b0$919f644d@foxbox> To: "Pierre Joye" Cc: "Vesselin Kenashkov" , "Hannes Magnusson" , "Lukas Kahwe Smith" , "PHP Internals List" References: <53C9D049-8C10-48F2-8312-C8A81D2B5990@pooteeweet.org> <00a601c98c7b$4ed5a4a0$919f644d@foxbox> <7f3ed2c30902111113q364b4094q22c71c1046a984a6@mail.gmail.com> <00c301c98c7d$da9cce80$919f644d@foxbox> <00d401c98c7e$a92bfcd0$919f644d@foxbox> <261daaa10902111131u61ad7ec9s9257a45e1e11f086@mail.gmail.com> <00ec01c98c81$2696b2d0$919f644d@foxbox> Date: Wed, 11 Feb 2009 19:55:33 -0000 MIME-Version: 1.0 Content-Type: text/plain; format=flowed; charset="iso-8859-1"; reply-type=original Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2900.2180 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.2180 X-session-marker: 73746570682E666F78 Subject: Re: [PHP-DEV] 5.3 todos From: steph@php.net ("Steph Fox") > An upgrade is not only about problems, it is also about solutions. You need a problem before providing a solution. Really. > A > kind of tutorial on how to use all the changes in a given release in > your applications. It often helps to clean codes, remove work 'round, > etc. An upgrade guide is often the document many will read, and not > the NEWS file, which is not that useful in the current format. They won't read it if it's too darn long :) Please go back to the original discussion about the purpose of this guide. It was aimed primarily at sysadmins. If we turn it into a prettier version of NEWS or release notes, all it means is we still need an upgrade file for sysadmins. So in response to Hannes' earlier question, yes I think these should be two separate documents - one for end users in the manual, one for sysadmins in the src. And no I don't mind writing both, I just want to be very clear about their purpose. - Steph