Re: (1)[0] ok but not 1[0]



as useful as you expect. there are dozens of perl tutorials on the net
and almost all are total crap and full of mistakes and bad writing. in
many cases the authors also were self taught and thought they can create
a better doc. turns out that writing technical docs (especially
tutorials) needs much more programming skill and tons of experience
which most of those authors don't have (or ever will have). some even

I think you and Charlton Wilbur are perfectly right. By no means will
the document I am writing be better than "Programming Perl" or
http://perldoc.perl.org/ or other established documentation from an
objective point of view. Of course it will have a lot of mistakes and
errors in it, since I will never be a Perl professional but at most an
experience Perl user.

However it will be better from my subjective point of view. Its closer
to the way I am thinking. Its the way I am learning stuff - by
writting things down. Order stuff on paper until I can fully
understand it and have a concise view on it.

I don't know exactly why - "The C++ Programming Language" is a book
that is much more clear to me than "Programming Perl" - and I don't
think its just because I already know C++ better. Its because of the
way things are explained, specified.

Maybe you are right and I shouldn't make it public, because it will
definitely have much more mistakes in it than any official
documentation. So there is a concern that it would only confuse
people. Then again maybe there are people who can profit from it.
Maybe I have to make it very very clear in the abstract and/or
introduction that it's a book written by a non-professional and thus
will contain tons of mistakes.

Flo
.



Relevant Pages

  • Re: top posting (off-topic)
    ... Wonderful things encouraged by people justifying their lazy writing styles. ... I'm not saying writing must be perfect, and I'm well aware of my own grammar shortcomings and I fully understand typos and mistakes. ... But there are also trends that I run into ALL THE TIME that are simply a case of people not taking a bit of care. ...
    (freebsd-questions)
  • Re: How did you learn your debugging skills?
    ... > I'm writing my quarterly column for Software Test & Performance ... mistakes are generally far between. ... how did you learn the debugging skills you ...
    (comp.programming)
  • Re: Reader feelings management OR rank your chapters OR "pre-crit"
    ... perspectives and in some kind of organizaed way that may lead into a ... Let's keep your idea at you gaining an insight about your writing (whoever ... claim to want to protect new writers from doing mistakes). ... It's kind of the autopilot reaction of the folks here, ...
    (rec.arts.sf.composition)
  • Re: Where to start?
    ... Conrad wasn't a native English speaker, ... I make mistakes, too, and I can bear my level of inaccuracy, but Gwyn often ... does not extend to writing. ... >> correct style for Americans to imitate. ...
    (sci.crypt)
  • Re: Does your reading corrupt your writing?
    ... I've even found myself writing plural's. ... But even more worrying is that I now sometimes make the same mistakes when I'm writing longhand. ... Or I head for a familiar word and my fingers go one space to the left. ... Jacey Bedford ...
    (rec.arts.sf.composition)