Re: opinions wanted!

Liz,

Just going through it and skimming and making notes, here are some that jump
out (oh, and ignore anything that you may cover later in the document, I'm
sorta commenting as I skim):

1. Use Borland style coding conventions for your code samples. Yes,
everyone has their own style but for any type of tutorial I think it's
always best to stick as true to the environment you are working in's native
style. It also makes it feel more "official".

2. Try and sneak the "proper names" of things into the verbiage. For
example it's pretty standard to call "if..then..else" a flow control
structure so in the description perhaps mentioning how it affects the flow
of your program. That'll help the reader later when they read something a
bit more technical and it refers to flow structures.

3. You talk about coding conventions and naming conventions but don't really
offer any advice on what to do. Granted everyone should decide for
themselves (and will) but beginners usually want someone to tell them what
to do and then they'll evolve their own style. Again, I'd stick with
Borland style because it's a great common base and when I query most Delphi
software houses that's more often than not the standard they pick.

Oops, real work calls. So far it's great besides the few nitpicks (will
look more later, found a few typos).

Shawn


"Liz" <liz_wants_no_spam@xxxxxxxxxxxxxxxxxxxxx> wrote in message
news:xn0eaaech8ty2100f@xxxxxxxxxxxxxxxxxxxxxxxxx
> Hi guys,
>
> You guys live and breathe delphi way more than I do.
>
> Currently my D2005 tutorial is about 49 pages long, and in essense is
> very weak (IMHO)
>
> Obviously with the up coming 2006.. Im hoping to extend, one day, to
> include some of the 2006 bits, but, at this time Id guess most of whats
> in there, is likely to be true of 2006 as much as 2005 (as its not that
> strong a tutorial)
>
> What I would like is some more enlightened feedback. The stuff Ive had
> from those who dont know delphi or werent sure much is that they love
> it.
>
> However, that just means to me, I told them something they didnt know,
> that doesnt imply its actually any good!
>
> Could you please drop in (its off the link below) and use the
> suggestion thing to let me know?? Thanks
>
> --
> Liz the Brit
> Delphi things I have released: http://www.xcalibur.co.uk/DelphiThings


.

Relevant Pages