|
Marc Clifton wrote: Lots of man-hours wasted, but fortunately the people higher up on the food chain amazingly recognize the need for good documentation so that waste of time doesn't have to be repeated by future people that the company brings on board for the project.
Good on ya. At least you have a place that likes that you can write.
Not something I have been able to get lately. Usually they just want me to crank out the code and let others, like yourself, document the process.
|
|
|
|
|
You have such an interesting attitude. Why is that?
Frankly, I often find that if I do some up-front documentation / design, not only does it make it clearer what needs to be coded, but I can also provide better estimates. It also often highlights sometimes significant problems that end up causing re-thinks of major sections of the code.
Marc
|
|
|
|
|
Marc Clifton wrote: You have such an interesting attitude. Why is that?
Because I have been around for 40 years.
Oh yes I am jaded. I used to think like you but the reality is that they want you to crank out code.
|
|
|
|
|
JimmyRopes wrote: Because I have been around for 40 years.
In the industry, or total years of life? I'm 51, been programming since I was 12. What I hear is a lot of bitterness. Yes, working in this industry has left me rather jaded, but there are definitely some gems that I have enjoyed, but people and jobs.
Marc
|
|
|
|
|
Marc Clifton wrote: In the industry, or total years of life?
In the industry.
Marc Clifton wrote: What I hear is a lot of bitterness.
Yes it is reality hitting a former optimist in the face.
Marc Clifton wrote: Yes, working in this industry has left me rather jaded, but there are definitely some gems that I have enjoyed
Me too but they are few and far between.
For the most part people pay you to code what they want, period.
What you think is, at best, just your opinion.
Good luck with that!
|
|
|
|
|
Some companies actually forbid you to write articles.
|
|
|
|
|
Writing articles is hard work. When the article seems to go unnoticed once it posted does not make it any easier. I guess posting a message in the lounge about it would be a good way to get it noticed, but then the lounge would soon get filled with "New article" posts.
Within you lies the power for good - Use it!
|
|
|
|
|
They do appear on the home page - but how many regulars go there, except on Monday for the survey, and to check the moderation queue?
It would help if some of the QA posters would use the (heck, any) search facility - probably half of them could get a quicker solution from existing articles if they did...
Those who fail to learn history are doomed to repeat it. --- George Santayana (December 16, 1863 – September 26, 1952)
Those who fail to clear history are doomed to explain it. --- OriginalGriff (February 24, 1959 – ∞)
|
|
|
|
|
PJ Arends wrote: guess posting a message in the lounge about it would be a good way to get it noticed
Don't even think about it. 
|
|
|
|
|
Oh no, it would have to be subtle.
Within you lies the power for good - Use it!
|
|
|
|
|
OriginalGriff wrote: Is it just me, or is getting the words right a lot, lot harder than the code?
No, it's definitely not just you 
Cranking out the code for D3.js crash course - Part2[^] - and writing the article wan't all that hard as the code isn't very complicated.
On the other hand I put a lot of work into DBTool for Oracle - Part 1[^], and I'm pretty certain that I was unable to create an article that did justice to that effort. Too much information, unclear as to what the project really is about, etc...
So far I've found that it's extreemly hard to create readable material on anything but fairly simple subjects ...
|
|
|
|
|
Just yesterday I wrote an article about my software auto updater. It took me the better part of a day to write the software and about the same to write the article.
I have given up on the online editor. I just write it offline in html and paste it into the html box.
|
|
|
|
|
Yvan Rodrigues wrote: my software auto updater.
Last week I almost posted in the Hall of Shame how I broke our software auto updater in the last release...the one that most customers are now running!  At least it's an easy workaround. I will check out your article.
"Go forth into the source" - Neal Morse
|
|
|
|
|
Depends on the article. My latest two on SQL certainly took more time in writing the words than writing the queries. Together they took me about 100-150 hours to write.
The one before that, A Look under the hood of the .NET Framework, took a lot longer. I wasn't familiar with the stuff I was writing about and actually getting the code right was harder than getting the words right. I would spend hours getting the code right and looking up each and every opcode on Google and MSDN and then simply write down what I had done for the last few hours. I also did that article in both VB and C#, which also took quite some time to get right (both languages had to compile to the same IL).
And yes, a lot of time does go into fighting the submission wizard, unfortunately... 
|
|
|
|
|
I am a .NET trainer, so I'm very precise about the words I use in article and the one that my trainee use. I'm used to that, and I was not before. (A C++ programmer, that, in C#, calls a "field" an "attribute" is a cardinal sin for me. The reverse is true.)
Also, I use Windows live writer to write, and post-edit the article to make it works in the wizard. Writing article in the wizard in unproductive.
If it is hard to put things into words, I tend to search for flaws in my own understanding.
Everytimes I write an article it results in major refactoring of my project. Somehow, the human language catches flaws and semantic errors in my code better than the compiler.
Writing seems harder because it catches different type of errors your machine can't detect.
You don't have to write though. Just buy a rubber duck, works also for other purpose than debugging.
|
|
|
|
|
I used to use one of my bosses as a rubber duck when I had a complex problem. Since he was about as technical as my cat it worked fine, for me. For him, I think it made him feel "involved"... 
Those who fail to learn history are doomed to repeat it. --- George Santayana (December 16, 1863 – September 26, 1952)
Those who fail to clear history are doomed to explain it. --- OriginalGriff (February 24, 1959 – ∞)
|
|
|
|
|
ALL THE TIME
I answer questions on an almost daily basis on Lidnug (The LI UG I help run) , and time and time again I think to my self, gee that would make a great blog post, or a great CP Article or similar...
but guess what...
It never ends up getting written.
My new years resolution this year was to start blogging properly again, at least once a month.
I've already broken that resolution.
at least however, it's not a 100 page book....
oh wait... I have another of those coming up sometime in the future too...
Rats.
Guess I'll have to invent that auto article writing code sooner than I thought then.
Shawty 
|
|
|
|
|
Peter Shaw wrote: Guess I'll have to invent that auto article writing code sooner than I thought then.
Well, I hope you're going to write and article on it! 
Those who fail to learn history are doomed to repeat it. --- George Santayana (December 16, 1863 – September 26, 1952)
Those who fail to clear history are doomed to explain it. --- OriginalGriff (February 24, 1959 – ∞)
|
|
|
|
|
Yea I am.... just as soon as I finish writing that new web app I'm on with to get 48 Hours out of a 24 hour day ![Java | [Coffee]](https://codeproject.global.ssl.fastly.net/script/Forums/Images/coffee.gif)
and yes... that is a signal that copious amounts of caffeine WILL be needed.
|
|
|
|
|
Explaining what you did is the hardest part, I sometimes write articles (for my employer) and they almost always end up taking me a full day worth of work, despite the fact that what I write about is something I already did for a customer.
|
|
|
|
|
|
It's funny. Just talked about it with my mates in office this morning... Told them about my experience playing around with Intel XDK...
I'm not questioning your powers of observation; I'm merely remarking upon the paradox of asking a masked man who he is. (V)
|
|
|
|
|
|
Erudite_Eric wrote: but when the 5% that typifies their national character rises to the fore they are complete tossers.
And that 5% is permanently to the fore in Paris...
Those who fail to learn history are doomed to repeat it. --- George Santayana (December 16, 1863 – September 26, 1952)
Those who fail to clear history are doomed to explain it. --- OriginalGriff (February 24, 1959 – ∞)
|
|
|
|
|
Paris does seem to be the worst of it. Really, it is a sh*t hole. Annyone thinking of going there, dont, the food is sh*t, the people tossers, the authorities arrogant, abuseive, and will rip you off and even steal from you under threat of violence. And then you have the gypsy pick pockets...
modified 23-Feb-14 4:22am.
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
