#1
  1. Banned ;)
    Devshed Supreme Being (6500+ posts)

    Join Date
    Nov 2001
    Location
    Woodland Hills, Los Angeles County, California, USA
    Posts
    9,645
    Rep Power
    4248

    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

    "I wouldn't hire a butcher to fix my car. I also wouldn't hire a marketing firm to build my website." - Nilpo
  2. #2
  3. No Profile Picture
    Contributing User
    Devshed Novice (500 - 999 posts)

    Join Date
    Feb 2003
    Location
    Canada
    Posts
    543
    Rep Power
    24
    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.
  4. #3
  5. Mini me.
    Devshed Novice (500 - 999 posts)

    Join Date
    Nov 2003
    Location
    Cambridge, UK
    Posts
    783
    Rep Power
    14
    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.
  6. #4
  7. Banned ;)
    Devshed Supreme Being (6500+ posts)

    Join Date
    Nov 2001
    Location
    Woodland Hills, Los Angeles County, California, USA
    Posts
    9,645
    Rep Power
    4248
    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.
    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

    "I wouldn't hire a butcher to fix my car. I also wouldn't hire a marketing firm to build my website." - Nilpo
  8. #5
  9. No Profile Picture
    Contributing User
    Devshed Novice (500 - 999 posts)

    Join Date
    Feb 2003
    Location
    Canada
    Posts
    543
    Rep Power
    24
    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!
  10. #6
  11. Hello World :)
    Devshed Frequenter (2500 - 2999 posts)

    Join Date
    Mar 2003
    Location
    Hull, UK
    Posts
    2,537
    Rep Power
    69
    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.
    programming language development: www.netytan.com Hula

  12. #7
  13. Banned ;)
    Devshed Supreme Being (6500+ posts)

    Join Date
    Nov 2001
    Location
    Woodland Hills, Los Angeles County, California, USA
    Posts
    9,645
    Rep Power
    4248
    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 01:25 PM.
    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

    "I wouldn't hire a butcher to fix my car. I also wouldn't hire a marketing firm to build my website." - Nilpo
  14. #8
  15. No Profile Picture
    Contributing User
    Devshed Novice (500 - 999 posts)

    Join Date
    Feb 2003
    Location
    Canada
    Posts
    543
    Rep Power
    24
    "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.

Similar Threads

  1. tutorial for vb.net
    By dsridhar10 in forum .Net Development
    Replies: 2
    Last Post: February 3rd, 2004, 07:43 PM
  2. div scroll tutorial
    By ximensions in forum HTML Programming
    Replies: 3
    Last Post: January 22nd, 2004, 12:52 AM
  3. Replies: 0
    Last Post: July 29th, 2003, 09:26 AM
  4. Help wanted with writing kernel tutorial
    By telex4 in forum Linux Help
    Replies: 7
    Last Post: December 20th, 2002, 06:47 AM
  5. PHP tutorial - Not helping too much
    By metro in forum PHP Development
    Replies: 1
    Last Post: August 19th, 2002, 04:49 PM

IMN logo majestic logo threadwatch logo seochat tools logo