|
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.
modified 19-Feb-14 15:49pm.
|
|
|
|
|
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.
|
|
|
|
|
Pete O'Hanlon wrote: but getting someone's name wrong is very disrespectful. Making a mistake is never disrespectful.
Bastard Programmer from Hell
If you can't read my code, try converting it here[^]
|
|
|
|
|
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
If you can't read my code, try converting it here[^]
|
|
|
|
|
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
|
|
|
|
|
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
|
|
|
|
|
Sounds like a plan to me.
|
|
|
|
|
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
|
|
|
|
|
|
Running Windows users with ‘standard’ rather than ‘administrator’ rights would have removed over 90 percent of the risk posed by critical vulnerabilities reported in Microsoft products last year, an analysis by privilege management firm Avecto has found. Taking computers away from users removes 100% of the risk
|
|
|
|
|
If only Microsoft had introduced a way for everyone to run as a standard user, with a prompt to elevate to administrator when required. I'm sure nobody would ever complain about it, or turn it off because it got in the way of them opening the "FluffyBunniesAndTaxRefund.exe" attachment that the tax man just emailed to them from a .cn address.
"These people looked deep within my soul and assigned me a number based on the order in which I joined."
- Homer
|
|
|
|
|
How surprising. A company that has a product that is used in companies like banks to run applications with elevated privileges is pushing for computers to be run in a state where you need a product that runs applications with elevated privileges. #Whodathunkit.
|
|
|
|
|
After being used to typing "su" on the prompt, one wonders why it took so damn long on Windows
Bastard Programmer from Hell
If you can't read my code, try converting it here[^]
|
|
|
|
|
This seems more like an ad disguised as a news article.
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
|
|
|
|
|
They are right - but hardly anyone will follow them. Look around among your friends: a single computer for a whole family with one account (which is an admin account of course) - "Dad, why is the computer getting so slow" asked little Jonny after installing a dozen free apps. Or someone considering a password of less than 20 characters to short - of course, he's using an admin account only. It does not matter how easy it is to create "normal" user accounts - people won't do so.
|
|
|
|
|
In late 2013 we made available a prerelease NuGet package which allows running a managed web application directly on top of IIS without going through the normal ASP.NET (System.Web) request processing pipeline. All the fun of ASP.NET, less of the unfun
|
|
|
|
|
Some node.js for .NET... sounds good!
I'm not questioning your powers of observation; I'm merely remarking upon the paradox of asking a masked man who he is. (V)
|
|
|
|
|
The company is delving into “deep learning,” a branch of artificial intelligence that seeks to solve particularly hard problems using computer systems that mimic the structure and behavior of the human brain.
I hope the artificial brain has the voice of Kevin Spacey.
|
|
|
|
|
Maybe it'll come up with some good TV shows and meaningful episodes.
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
|
|
|
|
|
As opposed to most of the drivel on network television?
|
|
|
|
|
Duh.
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
|
|
|
|
|
|