C# coding style
-
Hi, for quite some time I am using my own C# style guide for my startup. It probably is among the C# style guides the one with the most variations from "official" style guides. However, all variations are principled and never just for the reason of being different. I would invite anybody to have a look at it. Maybe one or the other feature might prove beneficial for your own projects. It can be found here: http://chrisjacobi.wordpress.com[^] A separate discussion meta-topic might be: By using a style guide like this, will it attract stellar programmers because it is a nice style and gives enough individual freedom? Alternatively, would it deter first class programmers because they might oppose using a somewhat unusual style? Chris, www.whitehawksoftware.com[^]
-
spam
If your actions inspire others to dream more, learn more, do more and become more, you are a leader.-John Q. Adams
You must accept one of two basic premises: Either we are alone in the universe, or we are not alone in the universe. And either way, the implications are staggering.-Wernher von Braun
Only two things are infinite, the universe and human stupidity, and I'm not sure about the former.-Albert EinsteinNo its not. Its not trying to sell anything. Its certainly in the wrong forum, but that's something entirely different.
"If you don't fail at least 90 percent of the time, you're not aiming high enough." Alan Kay.
-
Doing it twice is, especially when you can see their name right there in front of you.
-
Marc, thanks for your comment. I have never written a style guide for the English language. Only a fool or an elementary school teacher would make the effort to read what I have to say about the English language; I certainly cannot refute your statement on polish. I disagree on whatever is the proper length. When I researched style guides I found some very short and to the point guides; I ignored many simply because I couldn't see the reasoning behind what they were saying. There is a 350 page book "Framework Design Guidelines" (mostly C#) [Google]. I think it is well written and has interesting inserts from different personalities. Nevertheless, I ignored most of it, mostly because it doesn't respect the limits of my attention span. Somewhat because is too general and doesn't contain what is specially important for my startup. And lastly, they didn't dare to disagree loudly enough with other standards. I think having some wiggle room is treating my cowerkers as professional adults. For the same reason it has very little trivial content. Examples would be nice, but most is for the benefit of programming-in-the-large, where I find it difficult to make reasonable examples. "Policing" is not something I like to do; The people I want to work with earn respect and absence of being policed. If you think there is nothing unusual and most is common sense, I think that this is a compliment to me, but in my opinion it also compliments on you. What has "Agile" have to do with "style?" Good question, but I am taking some wiggle room myself defining what is style. In what other document could I ramble about obsessive agile-ness in a reasonable way? And for anybody who has read till here: Google Marc on CodeProject; he has written some nice articles. Chris www.whitehawksoftware.com Edited to spell Marc's name corrctly.
I mostly agree with Marc that the baseline of the style guide should be short and to the point. Supplemental material explaining why can be helpful; but being able to fit the essentials onto at most a single sheet of paper so it can be stuck to the wall for easy reference by anyone new to the team is more useful. If you want to keep it in PDF form, the best option is probably just to add a 1 page short guide that only has the what not the why. If you're willing to switch to HTML format putting the explanation in default collapsed blocks would be better.
Did you ever see history portrayed as an old man with a wise brow and pulseless heart, waging all things in the balance of reason? Is not rather the genius of history like an eternal, imploring maiden, full of fire, with a burning heart and flaming soul, humanly warm and humanly beautiful? --Zachris Topelius Training a telescope on one’s own belly button will only reveal lint. You like that? You go right on staring at it. I prefer looking at galaxies. -- Sarah Hoyt
-
No its not. Its not trying to sell anything. Its certainly in the wrong forum, but that's something entirely different.
"If you don't fail at least 90 percent of the time, you're not aiming high enough." Alan Kay.
wrong forum = spam, and he's clearly advertising.
If your actions inspire others to dream more, learn more, do more and become more, you are a leader.-John Q. Adams
You must accept one of two basic premises: Either we are alone in the universe, or we are not alone in the universe. And either way, the implications are staggering.-Wernher von Braun
Only two things are infinite, the universe and human stupidity, and I'm not sure about the former.-Albert Einstein -
what makes you say that ? did you read his 'coding standards' - your post is actually more spam than his, since you barely managed to give a one-word reply
I'd say that putting links into his post linking to his company which is aiming to have a commercial product out in the next month counts as spamming. The blog post was fine - the link to his company was gratuitous.
-
Doing it twice is, especially when you can see their name right there in front of you.
Pete O'Hanlon wrote:
Doing it twice is, especially when you can see their name right there in front of you.
Call it a bug; one can overlook a simple typo quickly - let's not suggest that it has anything to do with respect.
Bastard Programmer from Hell :suss: If you can't read my code, try converting it here[^]
-
Please take the opportunity to spell Marc's name properly. I know you don't mean it, but getting someone's name wrong is very disrespectful.
Marc doesn't need any help defending himself. He's got cred.
If your actions inspire others to dream more, learn more, do more and become more, you are a leader.-John Q. Adams
You must accept one of two basic premises: Either we are alone in the universe, or we are not alone in the universe. And either way, the implications are staggering.-Wernher von Braun
Only two things are infinite, the universe and human stupidity, and I'm not sure about the former.-Albert Einstein -
Marc doesn't need any help defending himself. He's got cred.
If your actions inspire others to dream more, learn more, do more and become more, you are a leader.-John Q. Adams
You must accept one of two basic premises: Either we are alone in the universe, or we are not alone in the universe. And either way, the implications are staggering.-Wernher von Braun
Only two things are infinite, the universe and human stupidity, and I'm not sure about the former.-Albert EinsteinHe's also got me. I'll go all Krav Maga on anyone who disses my main man.
-
He's also got me. I'll go all Krav Maga on anyone who disses my main man.
Shields down! Deactivate waepons! At ease! Sounds like you need extended shore leave.
If your actions inspire others to dream more, learn more, do more and become more, you are a leader.-John Q. Adams
You must accept one of two basic premises: Either we are alone in the universe, or we are not alone in the universe. And either way, the implications are staggering.-Wernher von Braun
Only two things are infinite, the universe and human stupidity, and I'm not sure about the former.-Albert Einstein -
Shields down! Deactivate waepons! At ease! Sounds like you need extended shore leave.
If your actions inspire others to dream more, learn more, do more and become more, you are a leader.-John Q. Adams
You must accept one of two basic premises: Either we are alone in the universe, or we are not alone in the universe. And either way, the implications are staggering.-Wernher von Braun
Only two things are infinite, the universe and human stupidity, and I'm not sure about the former.-Albert EinsteinSounds like a plan to me.
-
I'd say that putting links into his post linking to his company which is aiming to have a commercial product out in the next month counts as spamming. The blog post was fine - the link to his company was gratuitous.
His account is several years old. I lean strongly toward stupidity over malice.
Did you ever see history portrayed as an old man with a wise brow and pulseless heart, waging all things in the balance of reason? Is not rather the genius of history like an eternal, imploring maiden, full of fire, with a burning heart and flaming soul, humanly warm and humanly beautiful? --Zachris Topelius Training a telescope on one’s own belly button will only reveal lint. You like that? You go right on staring at it. I prefer looking at galaxies. -- Sarah Hoyt