dbTalk Databases Forums  

Developer Standards Doc

comp.databases.pick comp.databases.pick


Discuss Developer Standards Doc in the comp.databases.pick forum.



Reply
 
Thread Tools Display Modes
  #1  
Old   
dtsig
 
Posts: n/a

Default Developer Standards Doc - 02-07-2007 , 04:02 PM






I am wondering if anyone has any 'standards' documents that they give
incoming programmers. If so I would like to get a copy (if not
proprietary) so I can smudge into a document we are creating here.
There have never been any standards documents and I would like to see
it here.

I am not really trying to start a discussion here (best for/next
etc .. or best editor but would like to see what people have.

I will be happy to make available any ending document we have
generated.

Thanks


Reply With Quote
  #2  
Old   
Ed Sheehan
 
Posts: n/a

Default Re: Developer Standards Doc - 02-07-2007 , 04:21 PM






"dtsig" <dtsig (AT) hotmail (DOT) com> wrote

Quote:
I am wondering if anyone has any 'standards' documents that they give
incoming programmers. If so I would like to get a copy (if not
proprietary) so I can smudge into a document we are creating here.
There have never been any standards documents and I would like to see
it here.

I am not really trying to start a discussion here (best for/next
etc .. or best editor but would like to see what people have.
<snip>

You should always use LOOP/REPEAT. Stay away from FOR/NEXT - it will only
cause grief.

And anyone who isn't using EditPlus for editing should be strung up.

Ed "Always trying to create trouble" Sheehan :-)

Quote:
I will be happy to make available any ending document we have
generated.

Thanks




Reply With Quote
  #3  
Old   
Mark Brown
 
Posts: n/a

Default Re: Developer Standards Doc - 02-07-2007 , 04:26 PM



Every standards document I have seen in almost 40 years have always been the
same. Do this; don't do that. Well, do THIS means don't do THAT. So there
is only one standard:

Don't do anything we can't maintain when you're gone.


"dtsig" <dtsig (AT) hotmail (DOT) com> wrote

Quote:
I am wondering if anyone has any 'standards' documents that they give
incoming programmers. If so I would like to get a copy (if not
proprietary) so I can smudge into a document we are creating here.
There have never been any standards documents and I would like to see
it here.

I am not really trying to start a discussion here (best for/next
etc .. or best editor but would like to see what people have.

I will be happy to make available any ending document we have
generated.

Thanks




Reply With Quote
  #4  
Old   
Tony Gravagno
 
Posts: n/a

Default Re: Developer Standards Doc - 02-07-2007 , 08:53 PM



"dtsig" wrote:

Quote:
I am wondering if anyone has any 'standards' documents...
This topic has been discussed a number of times here and usually leads
to very long threads, in-fighting, etc. Bottom line is, it is
whatever you say it is.

Search through Google groups.
Here is an example query for "coding standards":
<http://groups.google.com/groups?q=%22coding+standards%22+group:comp.databas es.pick>

Here are a couple examples of prior discussions:
http://tinyurl.com/2opekj (standards)
http://tinyurl.com/2qycp6 (programmer abilities)
http://tinyurl.com/3ylsro (what is good code?)
http://tinyurl.com/3aglly (preferred constructs)
http://tinyurl.com/35w3tx (good programming practices)
http://tinyurl.com/2qcarr (actual standards doc by Steve Alexander)
http://tinyurl.com/3bv2af (coding nightmares discovered during Y2K)
http://tinyurl.com/3yph6k (more commends on standards)

I hope that's a good start for ya.

T






Reply With Quote
  #5  
Old   
Mike Preece
 
Posts: n/a

Default Re: Developer Standards Doc - 02-08-2007 , 07:37 AM



On Feb 8, 2:53 am, Tony Gravagno
<g6q3x9lu53... (AT) sneakemail (DOT) com.invalid> wrote:
Quote:
"dtsig" wrote:
I am wondering if anyone has any 'standards' documents...

This topic has been discussed a number of times here and usually leads
to very long threads, in-fighting, etc. Bottom line is, it is
whatever you say it is.

Search through Google groups.
Here is an example query for "coding standards":
http://groups.google.com/groups?q=%2...2+group:comp.d...

Here are a couple examples of prior discussions:http://tinyurl.com/2opekj(standards)...cp6(programmer abilities)http://tinyurl.com/3ylsro(what is good code?)http://tinyurl.com/3aglly(preferred constructs)http://tinyurl.com/35w3tx(good programming practices)http://tinyurl.com/2qcarr(actual standards doc by Steve Alexander)
In the doc referred to above, where the following code is given...

*
400 * see if the trial is prime
*
PRIME = 1
IF TRIAL < 4 THEN RETURN
LIMIT = INT(SQRT(TRIAL)) + 1
FOR I = 2 TO LIMIT WHILE PRIME
IF NOT(MOD(TRIAL,I)) THEN PRIME = 0
NEXT I
RETURN

....change "FOR I = 2 TO LIMIT WHILE PRIME" to:
IF MOD(TRIAL,2) THEN
PRIME = 0
END ELSE
FOR I=3 TO LIMIT STEP 2 WHILE PRIME
and insert "END" after "NEXT I"

Also, it is a good idea to restrict subroutines to a single entry
point and a single exit point (RETURN statement) - hence the IF
THEN...END ELSE...END construct I employed rather than use another
RETURN statement. Following on from this, use CASE constructs rather
than:
IF...THEN
....
END ELSE
IF...THEN
....
END ELSE
IF...THEN
....
END
END
END

Mike.

http://tinyurl.com/3bv2af(coding nightmares discovered during
Y2K)http://tinyurl.com/3yph6k(more commends on standards)
Quote:
I hope that's a good start for ya.

T



Reply With Quote
  #6  
Old   
mdsi2000
 
Posts: n/a

Default Re: Developer Standards Doc - 02-08-2007 , 08:07 AM



On Feb 7, 5:02 pm, "dtsig" <d... (AT) hotmail (DOT) com> wrote:
Quote:
I am wondering if anyone has any 'standards' documents that they give
incoming programmers. If so I would like to get a copy (if not
proprietary) so I can smudge into a document we are creating here.
There have never been any standards documents and I would like to see
it here.

My advice is "consistency before efficiency". It works for me and the
people that have worked for me. Two, three, four years down the road
you will see the results when you have to modify a program.
Modifications and enhancements will be a lot easier.

Here is one tip I learned from an old friend. If you are using a LOOP/
REPEAT use EXIT and CONTINUE see the following. It makes reading the
code easier for both entry level and seasoned programmers.

LOOP
READNEXT ID ELSE EXIT (takes you out of the LOOP/REPEAT)
READ R.REC FROM F.FILE, ID ELSE R.REC = ''
IF R.REC<5> = 'Y' THEN CONTINUE (skips down to the REPEAT and up
to the LOOP for the next ID)
......
......
REPEAT


BTW: I never use a LOOP/REPEAT UNTIL DONE DO! Some of these statements
could be confusion to follow.

Peter



Reply With Quote
  #7  
Old   
dtsig
 
Posts: n/a

Default Re: Developer Standards Doc - 02-08-2007 , 08:46 AM



On Feb 7, 6:53 pm, Tony Gravagno
<g6q3x9lu53... (AT) sneakemail (DOT) com.invalid> wrote:
Quote:
"dtsig" wrote:
I am wondering if anyone has any 'standards' documents...

This topic has been discussed a number of times here and usually leads
to very long threads, in-fighting, etc. Bottom line is, it is
whatever you say it is.

Search through Google groups.
Here is an example query for "coding standards":
http://groups.google.com/groups?q=%2...2+group:comp.d...

Here are a couple examples of prior discussions:http://tinyurl.com/2opekj(standards)...cp6(programmer abilities)http://tinyurl.com/3ylsro(what is good code?)http://tinyurl.com/3aglly(preferred constructs)http://tinyurl.com/35w3tx(good programming practices)http://tinyurl.com/2qcarr(actual standards doc by Steve Alexander)http://tinyurl.com/3bv2af(coding nightmares discovered during Y2K)http://tinyurl.com/3yph6k(more commends on standards)

I hope that's a good start for ya.

T
It is funny .. i specifically said i didn't want to get into a
debate. If someone had a document cool .. if not .. then they should
have moved on.




Reply With Quote
  #8  
Old   
Mike Preece
 
Posts: n/a

Default Re: Developer Standards Doc - 02-08-2007 , 09:26 AM



On Feb 8, 2:53 am, Tony Gravagno
<g6q3x9lu53... (AT) sneakemail (DOT) com.invalid> wrote:
Quote:
"dtsig" wrote:
I am wondering if anyone has any 'standards' documents...

This topic has been discussed a number of times here and usually leads
to very long threads, in-fighting, etc. Bottom line is, it is
whatever you say it is.

Search through Google groups.
Here is an example query for "coding standards":
http://groups.google.com/groups?q=%2...2+group:comp.d...

Here are a couple examples of prior discussions:http://tinyurl.com/2opekj(standards)...cp6(programmer abilities)http://tinyurl.com/3ylsro(what is good code?)http://tinyurl.com/3aglly(preferred constructs)http://tinyurl.com/35w3tx(good programming practices)http://tinyurl.com/2qcarr(actual standards doc by Steve Alexander)
In the doc referred to above, where the following code is given...

*
400 * see if the trial is prime
*
PRIME = 1
IF TRIAL < 4 THEN RETURN
LIMIT = INT(SQRT(TRIAL)) + 1
FOR I = 2 TO LIMIT WHILE PRIME
IF NOT(MOD(TRIAL,I)) THEN PRIME = 0
NEXT I
RETURN


....change "FOR I = 2 TO LIMIT WHILE PRIME" to:
IF NOT(MOD(TRIAL,2)) THEN
PRIME = 0
END ELSE
FOR I=3 TO LIMIT STEP 2 WHILE PRIME
and insert "END" after "NEXT I"


Also, it is a good idea to restrict subroutines to a single entry
point and a single exit point (RETURN statement) - hence the IF
THEN...END ELSE...END construct I employed rather than use another
RETURN statement. Following on from this, use CASE constructs rather
than:
IF...THEN
....
END ELSE
IF...THEN
....
END ELSE
IF...THEN
....
END
END
END


Mike.


http://tinyurl.com/3bv2af(coding nightmares discovered during
Y2K)http://tinyurl.com/3yph6k(more commends on standards)
Quote:
I hope that's a good start for ya.

T



Reply With Quote
  #9  
Old   
Tony Gravagno
 
Posts: n/a

Default Re: Developer Standards Doc - 02-08-2007 , 03:00 PM



http://tinyurl.com/2qcarr

You're quite welcome. Moving on now.

Reply With Quote
Reply




Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off



Powered by vBulletin Version 3.5.3
Copyright ©2000 - 2012, Jelsoft Enterprises Ltd.