Encodo C# Handbook
-
Encodo C# Handbook[^] This was a link from the MSDN C# dev centre. I'm finding it quite instructive. I don't agree with (or understand) it all but it's mostly pretty good. I'm always re-evaluating my style and practices. It's up to date with C# 3 btw.
Kevin
-
Encodo C# Handbook[^] This was a link from the MSDN C# dev centre. I'm finding it quite instructive. I don't agree with (or understand) it all but it's mostly pretty good. I'm always re-evaluating my style and practices. It's up to date with C# 3 btw.
Kevin
Does this count as a programming post? :-D
------------------------------------ "October: This is one of the peculiarly dangerous months to speculate in stocks in." - Mark Twain
-
Does this count as a programming post? :-D
------------------------------------ "October: This is one of the peculiarly dangerous months to speculate in stocks in." - Mark Twain
Only if it's auto generated
Panic, Chaos, Destruction. My work here is done.
-
Does this count as a programming post? :-D
------------------------------------ "October: This is one of the peculiarly dangerous months to speculate in stocks in." - Mark Twain
-
Encodo C# Handbook[^] This was a link from the MSDN C# dev centre. I'm finding it quite instructive. I don't agree with (or understand) it all but it's mostly pretty good. I'm always re-evaluating my style and practices. It's up to date with C# 3 btw.
Kevin
Who are these Encodo guys and why do we have to use their style? Has MS officially endorsed it?
-
Encodo C# Handbook[^] This was a link from the MSDN C# dev centre. I'm finding it quite instructive. I don't agree with (or understand) it all but it's mostly pretty good. I'm always re-evaluating my style and practices. It's up to date with C# 3 btw.
Kevin
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego. -
Who are these Encodo guys and why do we have to use their style? Has MS officially endorsed it?
You don't have to use anything. :) However, the document is not all style. Much of it is about practice and, as such, is more objective than mere style. The Encodo handbook is a sort of superset of MS's Design Guidelines for Developing Class Libraries. Whenever I see guidelines such as these I use them as things to think about and then I may adopt various suggestions as takes my fancy.
Kevin
-
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Post it!
-
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Ennis Ray Lynch, Jr. wrote:
There is a special circle of hell for the bigots that write these documents.
Well, to be fair this document is not entirely about style. Some of it is about practice, which is more objective.
Ennis Ray Lynch, Jr. wrote:
The real irony is that style guide is somehow read as style law?
Yes, the operative word should be "guide."
Kevin
-
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.I second what PIEBALDconsult said. Post it.
Simon
-
Post it!
I will think about re-authoring it and publishing it, however, I can't post it as it is a confidential document that doesn't belong to me. (What a silly cop-out, no?)
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego. -
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.I do agree. There should be just a (possibly short) style guide. :)
If the Lord God Almighty had consulted me before embarking upon the Creation, I would have recommended something simpler. -- Alfonso the Wise, 13th Century King of Castile.
This is going on my arrogant assumptions. You may have a superb reason why I'm completely wrong. -- Iain Clarke
[My articles] -
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Ennis Ray Lynch, Jr. wrote:
It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice.
That's quality control for you - it's quantity not quality.
Deja View - the feeling that you've seen this post before.
-
There is a special circle of hell for the bigots that write these documents. There, I said it, flame me if you wish. I will be busy writing good code that doesn't conform. BTW, to admit hypocrisy, I once wrote a style guide. It was only two pages long, incorporated everything, and would have fixed 90% (I am not exaggerating) of the problems on the project it was written for, and was flexible enough, to gasp, accommodate people. The reason it was rejected was not because of content, the content was approved and lauded. It was rejected because a style guide that small was not believable and they wanted a massive all controlling document that left nothing to choice. The real irony is that style guide is somehow read as style law?
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Totally agree with you. I had a look at that link, and just couldn't be bothered with that guide after a couple of pages. You could guess its been commissioned by a big company, with a team of people sitting through meeting after meeting, for months on end until they could come up with something that everyone would agree to. And they end up with a document so long its virtually unfit for purpose.
Words fade as the meanings change, but somehow, it don't bother me.
-
I will think about re-authoring it and publishing it, however, I can't post it as it is a confidential document that doesn't belong to me. (What a silly cop-out, no?)
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.What if we create a fake company, that fake hires you, on a fake project to create a "style guide" for our new fake project. In the process, we, the fake company, agree that publishing your guide would be a wonderful idea, and allow you free reign to do so. I've got a fake contract ready to go...
¡El diablo está en mis pantalones! ¡Mire, mire! Real Mentats use only 100% pure, unfooled around with Sapho Juice(tm)! SELECT * FROM User WHERE Clue > 0 0 rows returned Save an Orange - Use the VCF! VCF Blog
-
What if we create a fake company, that fake hires you, on a fake project to create a "style guide" for our new fake project. In the process, we, the fake company, agree that publishing your guide would be a wonderful idea, and allow you free reign to do so. I've got a fake contract ready to go...
¡El diablo está en mis pantalones! ¡Mire, mire! Real Mentats use only 100% pure, unfooled around with Sapho Juice(tm)! SELECT * FROM User WHERE Clue > 0 0 rows returned Save an Orange - Use the VCF! VCF Blog
mmmm, Fake compensation, yummy.
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego. -
mmmm, Fake compensation, yummy.
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Daft Faker, leader of the Microsoft Imperial Fleet?
------------------------------------ "October: This is one of the peculiarly dangerous months to speculate in stocks in." - Mark Twain
-
mmmm, Fake compensation, yummy.
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Plus, with the new McCain-Obama Tax Plan, there is NO tax on fake compensation under 2 billion dollars.
¡El diablo está en mis pantalones! ¡Mire, mire! Real Mentats use only 100% pure, unfooled around with Sapho Juice(tm)! SELECT * FROM User WHERE Clue > 0 0 rows returned Save an Orange - Use the VCF! VCF Blog
-
I will think about re-authoring it and publishing it, however, I can't post it as it is a confidential document that doesn't belong to me. (What a silly cop-out, no?)
Need software developed? Offering C# development all over the United States, ERL GLOBAL, Inc is the only call you will have to make.
Happiness in intelligent people is the rarest thing I know. -- Ernest Hemingway
Most of this sig is for Google, not ego.Modify it so it doesn't have any proprietary stuff and post it as an article. Dare!
-
Plus, with the new McCain-Obama Tax Plan, there is NO tax on fake compensation under 2 billion dollars.
¡El diablo está en mis pantalones! ¡Mire, mire! Real Mentats use only 100% pure, unfooled around with Sapho Juice(tm)! SELECT * FROM User WHERE Clue > 0 0 rows returned Save an Orange - Use the VCF! VCF Blog
The Cake is a Fake.
Todd Smith