Home | Contact Us | FAQ | Search & Site Map | Link to Us
Sign In | Join | Other 45 Sites in Network
HomeAnnouncementsFree MagazinesWhite PapersSubmit Content
Discussion GroupsASP.NETWindows FormsLanguages.NET FrameworkVisual Studio.NET
Articles.NET FrameworkASP.NETToolsWindows Forms
.NET DirectoryOpen Source ProjectsUser GroupsWeb Resources
Related Topics
Visual Basic 6SQL ServerMS AccessOther DB ProductsMS Server ProductsMore Topics ...

.NET Forum / Languages / C# / March 2008

Tip: Looking for answers? Try searching our database.

insignificant question about spelling

Thread view: 
Enable EMail Alerts  Start New Thread
Thread rating: 
Peter - 07 Mar 2008 14:34 GMT
Hi

with regards to naming - eg methods or properties - I wonder sometimes
about British vs American spelling. The c# language obviously uses
American spelling, "serializable" or "color" for example.

In my classes should I also follow this? Or is it ok to use British
spelling?

Recently for example I had to write a method to serialise some data,
and I called it SerialiseUser. Would this confuse other programmers?

What about a method "Color GetColour()"?

/Peter

--
Jon Skeet [C# MVP] - 07 Mar 2008 14:42 GMT
> with regards to naming - eg methods or properties - I wonder sometimes
> about British vs American spelling. The c# language obviously uses
[quoted text clipped - 7 lines]
>
> What about a method "Color GetColour()"?

If there are existing classes in the framework (or other libraries
you're using) which use the same word, I'd stick with that spelling. If
it's terminology which is relatively local, I'd use that. So, for
instance:

Color BackgroundColor
bool HonourUserPreferences

Of course, if you're writing an internationally-available library, it's
probably best to stick with US English anyway. That also gives the
advantage of consistency, which is usually a good thing...

Signature

Jon Skeet - <skeet@pobox.com>
http://www.pobox.com/~skeet   Blog: http://www.msmvps.com/jon.skeet
World class .NET training in the UK: http://iterativetraining.co.uk

Peter Morris - 07 Mar 2008 14:56 GMT
I don't think you should use British (AKA "correct") spelling <grin> in your
libraries any more than someone else should use Turkish words.  On that
subject.....

http://mrpmorris.blogspot.com/2007/02/dotting-is-and-crossing-ts.html

:-)

I think you should stick to the standard so that the majority of people are
comfortable with it.  In the front end of my apps though I will write words
like "Metres".

Pete
Martin Bonner - 07 Mar 2008 17:38 GMT
> Hi
>
[quoted text clipped - 7 lines]
> Recently for example I had to write a method to serialise some data,
> and I called it SerialiseUser. Would this confuse other programmers?

Well, there are those of us who follow the Oxford English Dictionary
and prefer
SerializeUser anyway (following both the Latin root and the sound of
the word).

> What about a method "Color GetColour()"?

That just causes so much confusion, I think you are stuck with Color
GetColor().

What do other non-"En-us" speakers do?  Do Germans write "Color
BekommenFarbe()"
KWienhold - 12 Mar 2008 08:04 GMT
> What do other non-"En-us" speakers do?  Do Germans write "Color
> BekommenFarbe()"

Actually, that would more likely be "HoleFarbe()"; and no, we don't ;)
I use American English in my code, since its what the framework uses
and it may help future developers to maintain the code if they don't
speak German for whatever reason.
English is pretty much the lingua franca of our day, so I don't see a
problem with that approach.
The only frustrating thing is that many Germans don't really speak
English all that well, so sometimes you do end up with terribly named
functions or database fields/tables.

Kevin Wienhold
Arne Vajhøj - 08 Mar 2008 03:15 GMT
> with regards to naming - eg methods or properties - I wonder sometimes
> about British vs American spelling. The c# language obviously uses
[quoted text clipped - 7 lines]
>
> What about a method "Color GetColour()"?

You definitely should use english instead of your native language
(if it differs).

But I would say that US versus UK english is not important. It is all
about readability. British and americans are capable of reading each
others languages. The rest of us are probably not capable of telling
whether it is US or UK english anyway.

Consistency is always good, but there are many more important
areas to focus on.

Arne
Michael A. Covington - 08 Mar 2008 05:13 GMT
>> What about a method "Color GetColour()"?
>
[quoted text clipped - 5 lines]
> Consistency is always good, but there are many more important
> areas to focus on.

The problem is being able to remember how you yourself did it.  When in
England, I still write programs in American spelling because I don't want to
get 2 spellings of the same name into the same program.

As has been observed, the CLR forces some American spellings on us, such as
Color.
Arne Vajhøj - 08 Mar 2008 23:32 GMT
>>> What about a method "Color GetColour()"?
>> But I would say that US versus UK english is not important. It is all
[quoted text clipped - 8 lines]
> England, I still write programs in American spelling because I don't want to
> get 2 spellings of the same name into the same program.

Is that really a problem ?

I would have imagined that the compiler and intellisense would
find and resolve those problems rather quickly.

Arne
Christopher Van Kirk - 08 Mar 2008 05:56 GMT
On Fri, 07 Mar 2008 22:15:59 -0500, Arne Vajhoj <arne@vajhoej.dk>
wrote:

>> with regards to naming - eg methods or properties - I wonder sometimes
>> about British vs American spelling. The c# language obviously uses
[quoted text clipped - 20 lines]
>
>Arne

I'm a strong supporter of Esperanto for instance method definitions,
Kikongo for local variable definitions, Kalaallisut for member
variable definitions, and Hebrew for static variable defintions, and
Swahili for static member definitions.

Having said that, we do have had some difficulty finding people who
are comfortable with all these languages, so for the moment we make do
with American English.

Signature

Posted via a free Usenet account from http://www.teranews.com

Chris Dunaway - 10 Mar 2008 18:31 GMT
On Mar 8, 12:56 am, Christopher Van Kirk <chris.vank...@fdcjapan.com>
wrote:

> I'm a strong supporter of Esperanto for instance method definitions,
> Kikongo for local variable definitions, Kalaallisut for member
> variable definitions, and Hebrew for static variable defintions, and
> Swahili for static member definitions.

That's one way to obfuscate your code!

Chris
Martin Bonner - 11 Mar 2008 19:11 GMT
> > with regards to naming - eg methods or properties - I wonder sometimes
> > about British vs American spelling. The c# language obviously uses
[quoted text clipped - 10 lines]
> You definitely should use english instead of your native language
> (if it differs).
Why?

I can certainly see why you would want to use words from the Framework
for concepts that are covered by the framework.  But for problem
domain concepts, why bother translating them to English - particularly
as there may not /be/ an equivalent word in English.

> But I would say that US versus UK english is not important. It is all
> about readability. British and americans are capable of reading each
[quoted text clipped - 3 lines]
> Consistency is always good, but there are many more important
> areas to focus on.
Well, correctness trumps everything, but consistency is pretty near
the top of my list of desiderata.

I certainly regard a careful choice of names as important.
Arne Vajhøj - 12 Mar 2008 02:48 GMT
>> You definitely should use english instead of your native language
>> (if it differs).
> Why?

Because there will practically never be any guarantee that
the code will always be maintained by someone that understand
the native language. You can expect those that they will
understand english.

Arne

Rate this thread:







Free Magazines

Get these publications absolutely FREE for up to 12 months. There are no hidden fees and no obligation. Simply choose a title, complete the application form and submit it. Read more ...

Oracle MagazineNetwork ComputingComputer WorldBio-IT WorldeWeekInformation WeekInfosecurity
 
Sign In
Join
My Latest Posts
My Monitored Threads
My Blog
My Photo Gallery
My Profile
My Homepage

Start New Thread
Enable EMail Alerts
Rate this Thread



©2008 Advenet LLC   Privacy Policy - Terms of Use
This website includes both content owned or controlled by Advenet as well as content owned or controlled by third parties.