Re: Update PHPT details page.

On Thu, May 7, 2009 at 6:33 AM, Raghubansh <softvirus@gmail.com> wrote: > +1 from me. I second this. Very well done, Eric. :) I checked it out when I prepped my slides. Helped me tremendously! Till > Document is really good. I am sure this will help all new test writers. > One comment on description of --TEST-- section : >  I would be nice to talk(through example) about writing --TEST-- section > which indicates whether test is a basic/variation/error or give few example > to say if the test is a basic test --TEST-- section would look like this, > etc.  This will bring --TEST-- section inline with test generated by > generate_phpt.php > > with Regards, > Raghubansh > On Wed, May 6, 2009 at 2:13 PM, zoe <zoe.slattery@googlemail.com> wrote: > >> Eric Stewart wrote: >> >>> I've recently completed some documentation on the PHPT file layout. This >>> is >>> somewhat similar to http://qa.php.net/phpt_details.php >>> in that it lists >>> sections available for use in PHPT files. But this new document includes >>> sections not covered and it includes much more information such as: >>> description, whether it's a required section, requirements for the >>> section, >>> which test scripts support the section, format, sample snippets of the >>> section in use and full test samples backing the sample snippets. >>> >>> I originally wrote this in preparation for the Atlanta TestFest event. Zoe >>> has asked if I would consider converting this document for use as a >>> replacement for the current PHPT details page on the QA site. I agree with >>> him as I wrote this out of a necessity for better documentation and I >>> think >>> it best serves the community by becoming apart of the QA site rather than >>> a >>> link or article off my site. But I'm not one to make unilateral decisions >>> in >>> regards to any of my actions within the PHP community. So I now bring this >>> to the attention of the QA team and ask for your approval. >>> >>> Here is a link to a zip file containing a text version of the document >>> (Test >>> File Layout.txt). It also includes the sample tests for which I used to >>> generate the snippets. If approved, the details page will include links to >>> the sample_tests. These sample tests will be new PHP pages created and >>> stored within a sample_tests folder on the QA site. They will include the >>> QA >>> headers and footers and a link back to the referring details page. >>> >>> http://www.ericstewart.org/public/20090503/PHPT.zip >>> >>> Your "yes" or "no" vote and any feedback will be greatly >>> appreciated. >>> >>> >> Eric has done the work to integrate this with the existing QA pages, I've >> put a pre-view here >> http://www.zapt.info/phpt/qaweb/phpt_details.php, the >> fact that the formatting isn't quite right is my fault not Eric's, it does >> display correctly when integrated properly into the QA pages. I think this >> is a significant improvement to the existing text. >> >> I would like to propose that Eric's karma (originally obtained as part of >> last year's TestFest) is extended to include qaweb, if there are no -1 votes >> for this over the next 24 hours I will ask Derick to extend Eric's karma.. >> >> >> Zoe >> >> >> >> -- >> PHP Quality Assurance Mailing List >> <http://www.php.net/> >> To unsubscribe, visit: http://www.php.net/unsub.php >> >> > > > -- > with Regards, > Raghubansh >