|
Early on I spent a great deal of time on documentation only to have it never referenced. I don't mind doing training materials because they are used, but developer docs are a waste of time because devs don't look at it.
|
|
|
|
|
For one thing, managers generally don't factor documentation time into coding deadlines, so if you spend time documenting it can look like you aren't getting your "real" work done fast enough.
But the larger problem is keeping it up-to-date. You may have time to do the initial documentation, but are you going to have time to update it with every change? What about when another team member ninja-edits the code, are you going to regularly check and make sure the documentation still matches the code?
I used to try very hard to have good documentation, but I found it to be hopeless. You end up with outdated documentation, which is often worse than no documentation at all. I don't buy the "code should document itself" argument, but for practical purposes that's where we're at, even if you have documentation you still have to go through the code and make sure the documentation isn't lying to you.
Edit: There's one time when documentation should be mandatory: when you are leaving a job. You likely aren't going to be needed to meet a coding deadline during your last two weeks, so spend that time documenting the systems you've been responsible for so the next person has something to go by when they pick up those systems. It's good karma, and that's when documentation is really needed and will get read.
modified 19-Dec-14 12:14pm.
|
|
|
|
|
Sometimes documentation (and programs) takes on a life of its own. I keep running across snippets of code and documentation I wrote forty-plus years ago.
|
|
|
|
|
As many of you know I'm passing CP through a fine comb to find spam.
After days spent searching, pointing them to the forum, reporting spam and spammer and soliciting cooperation in kicking them I began to ask myself: "self, why do this people post in their personal forums all this spam, normally the same, under a ton of accounts? What do they gain of this?".
A quick search on st. Google brought me this articl, that points to a research of the profitability of spam. For those interested, here is the linkity[^] to the article.
EDIT: found one more here clickity[^]
Enjoy!
Geek code v 3.12
GCS d--- s-/++ a- C++++ U+++ P- L- E-- W++ N++ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t++ 5? X R++ tv-- b+ DI+++ D++ G e++>+++ h--- r++>+++ y+++*
Weapons extension: ma- k++ F+2 X
|
|
|
|
|
That simply goes for most advertising.
Bastard Programmer from Hell 
If you can't read my code, try converting it here[^]
|
|
|
|
|
I thought as much, but spam is actually negative, it is noise - it should give the opposite result, other than a sense of scam. I would never buy anything from such fishy figures, and I didn't think it could be so much profitable. I understand phishing - scams always work, and some phishing is actually well made. But spam... I never thought it could be so much profitable!
Geek code v 3.12
GCS d--- s-/++ a- C++++ U+++ P- L- E-- W++ N++ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t++ 5? X R++ tv-- b+ DI+++ D++ G e++>+++ h--- r++>+++ y+++*
Weapons extension: ma- k++ F+2 X
|
|
|
|
|
How is advertisment not negative noise?
Bastard Programmer from Hell
If you can't read my code, try converting it here[^]
|
|
|
|
|
I agree but advertisement is an agreement from the supplier of a service to the user - basically using the service you accept the existance of advertisement.
Spam is an advertisement disguised as a pertinent information in a stream of informations, it is plain noise in the sense that it disturbs an otherwise functional communication. Like Jeovah Witnesses that ring the doorbell on unday morning, or the ones that stops people in the streets.
While I may not have anything against advertisement posters in the streets I will surely be annoyed by someone interrupting my flow of actions with commercials, especially foul-smelling as the typical spam.
Geek code v 3.12
GCS d--- s-/++ a- C++++ U+++ P- L- E-- W++ N++ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t++ 5? X R++ tv-- b+ DI+++ D++ G e++>+++ h--- r++>+++ y+++*
Weapons extension: ma- k++ F+2 X
|
|
|
|
|
den2k88 wrote: ...be annoyed by someone interrupting my flow of actions with commercials,
Have you seen On-demand? It used to be that it acted like a dvd, hit a commercial, hit the fast forward button. A 2 minute commercial lasted 10 seconds. Now it seems the 2 minute commercial takes 4 minutes.
|
|
|
|
|
$65 million a year 
By the way have you tried this amazing product that enlarges your... Brain capacity? (well, that's where our brain is located according to women, anyway) 
My blog[ ^]
public class SanderRossel : Lazy<Person>
{
public void DoWork()
{
throw new NotSupportedException();
}
}
|
|
|
|
|
Sander Rossel wrote: By the way have you tried this amazing product that enlarges your... Brain capacity?
Does it enlarge the Bacon Lobe?
New version: WinHeist Version 2.1.0
There's a fine line between crazy and free spirited and it's usually a prescription.
I'm currently unsupervised, I know it freaks me out too but the possibilities are endless.
|
|
|
|
|
Quote: Three in every million spam emails sent solicits the desired action. O.k. so that’s only 0.0003%
More likely to hit the lotto.
New version: WinHeist Version 2.1.0
There's a fine line between crazy and free spirited and it's usually a prescription.
I'm currently unsupervised, I know it freaks me out too but the possibilities are endless.
|
|
|
|
|
Well yes but less expensive and on mass scale. Buying 1 million lottery tickets or playing 1 million lotto cards per day requires a significant investment, while sending 1 million spam mail or posts is inexpensive.
Really though, these numbers are incredible, I thought the would be much lower...
Geek code v 3.12
GCS d--- s-/++ a- C++++ U+++ P- L- E-- W++ N++ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t++ 5? X R++ tv-- b+ DI+++ D++ G e++>+++ h--- r++>+++ y+++*
Weapons extension: ma- k++ F+2 X
|
|
|
|
|
If "There's a sucker born every minute" then doing the math;
9000 / (1440 min/day) = 6.25
Therefore it would only take 6.25 days to create the clientele.
New version: WinHeist Version 2.1.0
There's a fine line between crazy and free spirited and it's usually a prescription.
I'm currently unsupervised, I know it freaks me out too but the possibilities are endless.
|
|
|
|
|
I've never tried it, but apparently a lot of people dig the stuff spam-maker-hormel-sees-3q-profit[^].
"the debugger doesn't tell me anything because this code compiles just fine" - random QA comment
"Facebook is where you tell lies to your friends. Twitter is where you tell the truth to strangers." - chriselst
|
|
|
|
|
den2k88 wrote: I began to ask myself: "self, why do this people post in their personal forums all this spam, normally the same, under a ton of accounts? What do they gain of this?"
They do this out of compassion for you, because they know how much you need to play the role of guardian.
cheers, Bill
«OOP to me means only messaging, local retention and protection and hiding of state-process, and extreme late-binding of all things. » Alan Kay's clarification on what he meant by the term "Object" in "Object-Oriented Programming."
|
|
|
|
|
They're doing a damn fine job if that is the case - maybe they're overdoing that a tad but it's nice to have so many people caring for me, I'm moved  
Geek code v 3.12
GCS d--- s-/++ a- C++++ U+++ P- L- E-- W++ N++ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t++ 5? X R++ tv-- b+ DI+++ D++ G e++>+++ h--- r++>+++ y+++*
Weapons extension: ma- k++ F+2 X
|
|
|
|
|
Last day at work in a week (24th).
Christmas in a week (25th).
Moving out of the house in a week (27th/28th).
Starting my new job in two weeks (jan. 2nd, which I didn't count because that's kind of included in the 'last day at work' (or vice versa)).
It sounds fun and not so fun at the same time
In any case I'll be glad when januari is over and everything feels a bit like normal again...
My blog[ ^]
public class SanderRossel : Lazy<Person>
{
public void DoWork()
{
throw new NotSupportedException();
}
}
|
|
|
|
|
Good luck you are tackling some very stressful situations. clickity[^]
New version: WinHeist Version 2.1.0
There's a fine line between crazy and free spirited and it's usually a prescription.
I'm currently unsupervised, I know it freaks me out too but the possibilities are endless.
|
|
|
|
|
Thanks. It's not that stressful though.
I didn't lose my job, I quit.
And I don't own much stuff, so I'll have everything over in a weekend.
Luckily I don't have any of the other three, which, in my opinion, are a lot worse than having to move some stuff
What I'm looking up against most are washing, cooking and cleaning. It's done for me now 
I guess I'm a very lucky guy 
My blog[ ^]
public class SanderRossel : Lazy<Person>
{
public void DoWork()
{
throw new NotSupportedException();
}
}
|
|
|
|
|
You are lucky indeed and young you have your whole life ahead of you.
New version: WinHeist Version 2.1.0
There's a fine line between crazy and free spirited and it's usually a prescription.
I'm currently unsupervised, I know it freaks me out too but the possibilities are endless.
|
|
|
|
|
so where are you now and where will you go?
|
|
|
|
|
If you mean living: From a really very small village in The Netherlands (actually just outside it in the 'polder', well, it's all polder where I live...) to another small village nearby
If you mean my work: I now work for a small company (six employees) that makes (Windows) desktop apps using a Microsoft technology stack, mainly for the food-, and specifically meat, industry in the Netherlands. And I'll be working for a somewhat larger company (about 40 employees) that does about the same, but more web-based, using different languages, databases, etc. on a global scale.
If you mean that in a more philosophical sense: Isn't that the question we all ask ourselves? We can plan our future, but reality is that you can never know what the future brings.
My blog[ ^]
public class SanderRossel : Lazy<Person>
{
public void DoWork()
{
throw new NotSupportedException();
}
}
|
|
|
|
|
You are experiencing a syzygy. 
Marc
|
|
|
|
|
I've never heard of a syzygy and yet it has so many definitions[^]... 
So I'm still not sure what it is you think I'm experiencing... Perhaps a 'union of opposites'?
I did check out the Japanese band Syzygys and one of the five bands called Syzygy though
My blog[ ^]
public class SanderRossel : Lazy<Person>
{
public void DoWork()
{
throw new NotSupportedException();
}
}
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
