|
|
|||||||||
|
|||||||||
| |||||||||
|
|
|
| |||||||||
![]() |
|
|
«
Previous Thread
|
Next Thread
»
|
Thread Tools | Search this Thread | Rate Thread | Display Modes |
|
|
|
Be the architects of evolution and help create the mobile internet future. It’s your move---enter to win here! |
|
#1
|
||||
|
||||
|
Please critique my tutorial
Hello All,
I finally got around to typing out an article in Python and I was wondering if I could get some feedback from you guys here. The article is a tutorial that deals with using ADO and python to work with databases. Please critique it and let me know if I need to improve it a bit .
__________________
Up the Irons What Would Jimi Do? Smash amps. Burn guitar. Take the groupies home. "Death Before Dishonour, my Friends!!" - Bruce D ickinson, Iron Maiden Aug 20, 2005 @ OzzFest Down with Sharon Osbourne Puzzle of the Month solved by sizeablegrin, etienne141 and L7Sqr, superior C/C++ programmers of the month |
|
#2
|
|||
|
|||
|
I really like the tutorial. It's easy to read. It answers a lot of questions. I have spotted some grammatical errors, though.
I could read the tutorial more carefully later tonight. I'm busy right now. But congratulations on writing a wonderful tutorial. I urge you all to give it a read. |
|
#3
|
||||
|
||||
|
Haven't used ADO before and your tutorial has a great intro with it's background to ODBC and ADO.
You might want to suggest that from adoconstants import * is only used to keep the examples uncluttered. Stops trivial criticism ![]() Nice one. |
|
#4
|
||||
|
||||
|
Thanks for the suggestions guys.
MasterChief: I've cleaned up a bit of the wording, but I would sure appreciate any pointers to the grammatical errors .Grim Archon: Added your suggestion. I actually had made a note to add a sidebar there, but it sort of slipped my mind -- good call there. BTW you guys get credits at the end of my article. |
|
#5
|
|||
|
|||
|
You need to capitalize all names and languages.
Examples: python should be Python. perl should be Perl. Also, add a period at the end of "etc". "etc." is an abbreviation for "et cetera". You should read through everything very carefully. I'm sure you'll be able to spot mistakes. Since the disclaimer is already bold, just use "Disclaimer" instead of "DISCLAIMER". Thanks for putting us in the credits. That was really cool of you! |
|
#6
|
||||
|
||||
|
Actually you should'nt use a capital for 'perl' since 'perl' is the name of the language and 'Perl' is the program that runs 'perl' scripts
...Often referd to in the 'perl' community as "a noobie mistake" lol but hey, when the only difference between the language and the interpreter is the case what do you exect . Very intersting topic scorpi, easy to read and packed full off info. Should go down a treat with Windows Python users .Mark. |
|
#7
|
||||
|
||||
|
I fixed the "etc." in the docs (I only found one without a period at the end.
)Oddly enough, three different people pointed out that I should fix my references to "perl" and "python". The reason I didn't capitalize perl or python was because I believe the perl community like to refer to the interpreter in lowercase. However, a lot of official documents do refer to it as Perl also. Therefore, I fixed all references of "perl" and "python" to "Perl" and "Python". "Vox populi, vox dei", I always say. Last edited by Scorpions4ever : February 17th, 2004 at 12:25 PM. |
|
#8
|
|||
|
|||
|
"Vox populi, vox dei"
"The voice of the people is the voice of God." I'm 100% positive that Python should be capitalized. Perl users are pretty weird, but I would capitalize "perl" when you are talking about the program that runs Perl, etc., etc. |
![]() |
| Viewing: Dev Shed Forums > Programming Languages > Python Programming > Please critique my tutorial |
| Thread Tools | Search this Thread |
| Display Modes | Rate This Thread |
|
|
|
|