Re: [Qscada-developers] R: Document templates

[Iain B. <ia...@ne...>]

Hi again, its the occasion-poster here :)

On Wed, 2006-12-13 at 04:22 -0800, Paolo Sereno wrote:
> Hi all,
>=20
> thank you for your effort and your ideas. I=C2=B4m honoured to work wit=
h
> you all.
>=20
> Talking about coding convention, I=C2=B4d like to invite you to conside=
r
> something like this
> http://www.cs.rice.edu/~dwallach/CPlusPlusStyle.html

Hmm, personally I don't like _some_ of the ideas here - such as its...,
their..., the...

at work, we use a similar style, with the type of variable / object
preceding it's name, like:

unsigned short usSomeVar;
int iSomeVar;

class CoolClass;

CoolClass oInstance; // o is for object!

and function names are FirstLetterCapitals or name_with_underscore.

I personally believe coding styles should be specific in some areas, but
general in others.  Specifics include tab widths, or "no tabs"; loop
structure, names, etc, but with a general neatness in layout.

Making the code easy to read and look "nice" can sometimes override the
coding style.


> Documents:

Making templates can be tricky, given different fonts, sizes, programs,
etc.  Perhaps we could provide a latex template for people to edit, and
just some font names and sizes to use for *-office programs.  Maybe we
give an example front page, and table of contents, then after that it's
up to the author...

cya,
--=20
Iain Buchanan <iaindb at netspace dot net dot au>

"If you want to travel around the world and be invited to speak at a lot
of different places, just write a Unix operating system."
(By Linus Torvalds)