Talk:Best Coding Practices

From Wikipedia, the free encyclopedia

This page gets into lifecycle, requirements, etc. best practices. But the title is *Coding* best practices.

Also, many of the best practices listed for requirements, architecture, etc. aren't necessarily best practices. For example, Extreme Programming disagrees with them, yet is a very valid methodology. DRogers 17:11, 12 September 2006 (UTC)

[edit] Criticism of Article content and tone.

As an informative article, I feel the article's casual and possibly lecturing tone detriments from the value or emphasis of the article. In certain places, (e.g a quick Google search will turn up...) the information source is vaguely hinted at.

As such, the article fails to

1. give a reasonably complete overall picture of coding conventions, 
2. link users to related topics, 
3. introduce them to related keywords and categories for the people looking for more in-depth information.

I feel that the format given below is more suited for

The format: Meaning of 'Best coding Practices', what do they refer to, not refer to.

What are the categories/conventions which are generally accepted as BCP?

No one set of practises. Situation specific.
Brief discussion of possible aims - ease and speed of development, less bugs, speed, stability, portability etc,
and how compromises are made on the priority of aims.
 Based on Language - General and specific coding conventions e.g. hungarian notation, 
 Based on desired results, who the end-user is, what his requirements are.

How does this translate into an approach at each level, e.g.

pre- and post- contracts for writing a procedural function, 
OOP based class-design, 
Design Patterns for local class-interactions, 
Modular approaches (Test driven development)
Implementational approaches (extreme programming)

Discussion of studies/recommendations/preferences of eminent figures in the industry.