Author: timbo Date: Thu Feb 28 02:24:18 2013 New Revision: 15576 Modified: dbi/trunk/DBI.pm
Log: polish up the GETTING HELP section of the docs Modified: dbi/trunk/DBI.pm ============================================================================== --- dbi/trunk/DBI.pm (original) +++ dbi/trunk/DBI.pm Thu Feb 28 02:24:18 2013 @@ -84,45 +84,57 @@ =head2 GETTING HELP -If you have questions about DBI, or DBD driver modules, you can get -help from the I<[email protected]> mailing list. You don't have to subscribe -to the list in order to post, though I'd recommend it. You can get help on -subscribing and using the list by emailing I<[email protected]>. - -I don't recommend the DBI cpanforum (at http://www.cpanforum.com/dist/DBI) -because relatively few people read it compared with [email protected]. - -To help you make the best use of the dbi-users mailing list, -and any other lists or forums you may use, I recommend that you read -"Getting Answers" by Mike Ash: L<http://mikeash.com/getting_answers.html>. - -If you think you've found a bug then please also read -"How to Report Bugs Effectively" by Simon Tatham: -L<http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>. - -The DBI home page at L<http://dbi.perl.org/> and the DBI FAQ -at L<http://faq.dbi-support.com/> may be worth a visit. -They include links to other resources, but are rather out-dated. +=head3 General Before asking any questions, reread this document, consult the archives and read the DBI FAQ. The archives are listed -at the end of this document and on the DBI home page. +at the end of this document and on the DBI home page L<http://dbi.perl.org/support/> You might also like to read the Advanced DBI Tutorial at L<http://www.slideshare.net/Tim.Bunce/dbi-advanced-tutorial-2007> -This document often uses terms like I<references>, I<objects>, -I<methods>. If you're not familiar with those terms then it would -be a good idea to read at least the following perl manuals first: -L<perlreftut>, L<perldsc>, L<perllol>, and L<perlboot>. +To help you make the best use of the dbi-users mailing list, +and any other lists or forums you may use, I recommend that you read +"Getting Answers" by Mike Ash: L<http://mikeash.com/getting_answers.html>. + +=head3 Mailing Lists + +If you have questions about DBI, or DBD driver modules, you can get +help from the I<[email protected]> mailing list. This is the best way to get +help. You don't have to subscribe to the list in order to post, though I'd +recommend it. You can get help on subscribing and using the list by emailing +I<[email protected]>. Please note that Tim Bunce does not maintain the mailing lists or the -web page (generous volunteers do that). So please don't send mail +web pages (generous volunteers do that). So please don't send mail directly to him; he just doesn't have the time to answer questions personally. The I<dbi-users> mailing list has lots of experienced people who should be able to help you if you need it. If you do email Tim he is very likely to just forward it to the mailing list. +=head3 Online + +StackOverflow has a DBI tag L<http://stackoverflow.com/questions/tagged/dbi> +with over 400 questions. + +The DBI home page at L<http://dbi.perl.org/> and the DBI FAQ +at L<http://faq.dbi-support.com/> may be worth a visit. +They include links to other resources, but I<are rather out-dated>. + +I don't recommend the DBI cpanforum (at http://www.cpanforum.com/dist/DBI) +because relatively few people read it compared with [email protected]. + +=head3 Reporting a Bug + +If you think you've found a bug then please read +"How to Report Bugs Effectively" by Simon Tatham: +L<http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>. + +Your problem is most likely related to the specific DBD driver module you're +using. If that's the case then click on the 'Bugs' link on the L<http://metacpan.org> +page for your driver. Only submit a bug report against the DBI itself if you're +sure that your issue isn't related to the driver you're using. + =head2 NOTES This is the DBI specification that corresponds to DBI version 1.623 @@ -2137,6 +2149,11 @@ provides a standard interface and framework for the drivers to operate within. +This document often uses terms like I<references>, I<objects>, +I<methods>. If you're not familiar with those terms then it would +be a good idea to read at least the following perl manuals first: +L<perlreftut>, L<perldsc>, L<perllol>, and L<perlboot>. + =head2 Architecture of a DBI Application
