The OFFICIAL programming thread
-
I can relate to this
Surprise! Developers' days ruined by interruptions and meetings, GitHub finds
If you want to be happy at work, never meet more than twice a day
-
@pakoon said in The OFFICIAL programming thread:
I can relate to this
If you want to be happy at work, never meet more than twice a day
-
One thing I do not understand it how you can write this whole damn app which is maybe thousands of lines, yet the documentation is written like a fucking riddle.
-
@lithu said in The OFFICIAL programming thread:
One thing I do not understand it how you can write this whole damn app which is maybe thousands of lines, yet the documentation is written like a fucking riddle.
Yeah, but does the app work correctly?
-
@lithu said in The OFFICIAL programming thread:
One thing I do not understand it how you can write this whole damn app which is maybe thousands of lines, yet the documentation is written like a fucking riddle.
There’s no comments in the source code?
-
@hog said in The OFFICIAL programming thread:
@lithu said in The OFFICIAL programming thread:
One thing I do not understand it how you can write this whole damn app which is maybe thousands of lines, yet the documentation is written like a fucking riddle.
There’s no comments in the source code?
Hol up! So now I have to go read through the source code instead of reading the documentation!!! FFS!
Source code:
Documentation:
-
@lithu said in The OFFICIAL programming thread:
Hol up! So now I have to go read through the source code
That’s where I write my documentation.
-
@hog said in The OFFICIAL programming thread:
@lithu said in The OFFICIAL programming thread:
Hol up! So now I have to go read through the source code
That’s where I write my documentation.
-
Documentation is like sex. When it’s good, it is very good. When it is bad, it is better than nothing.
-
Comments in the source code as documentation would be a step forward for my shitty developers.
-
@hog said in The OFFICIAL programming thread:
@lithu said in The OFFICIAL programming thread:
Hol up! So now I have to go read through the source code
That’s where I write my documentation.
in what language, australian or cambodian?
If no set of moral ideas were truer or better than any other, there would be no sense in preferring civilized morality to savage morality, or Christian morality to Nazi morality. In fact, of course, we all do believe that some moralities are better than others . . . . The moment you say that one set of moral ideas can be better than another, you are, in fact, measuring them both by a standard . . . admitting that there is such a thing as a real Right, independent of what people think, and that some people's ideas get nearer to that real Right than others."
-
@whoofe said in The OFFICIAL programming thread:
@hog said in The OFFICIAL programming thread:
@lithu said in The OFFICIAL programming thread:
Hol up! So now I have to go read through the source code
That’s where I write my documentation.
in what language, australian or cambodian?
Australia doesn’t have computers.
-
How fun that would be if the guy who had to upgrade Hog’s code opens the source and it’s written in Khmer.
-
Binary…so when the aliens arrive they can play two
-
@lithu said in The OFFICIAL programming thread:
One thing I do not understand it how you can write this whole damn app which is maybe thousands of lines, yet the documentation is written like a fucking riddle.
Job security.
-
I can’t remember the last time I was asked write documentation. Must have been a decade ago. Me and my current boss maintain each others code all the time and it’s rare that either of us had to ask the other “wtf are you doing here”. We’re both pretty good coders though even if I do say so myself.
Edit: We’re both also mostly writing medium sized web apps and the backend services to support them. Not mission control launch programs.
-
-
@hog said in The OFFICIAL programming thread:
I can’t remember the last time I was asked write documentation. Must have been a decade ago. Me and my current boss maintain each others code all the time and it’s rare that either of us had to ask the other “wtf are you doing here”. We’re both pretty good coders though even if I do say so myself.
Edit: We’re both also mostly writing medium sized web apps and the backend services to support them. Not mission control launch programs.
What kind of web apps?
"Let's give it a week! Still a disaster? Let's give it another week…" -Tazz
-
@hog said in The OFFICIAL programming thread:
I can’t remember the last time I was asked write documentation. Must have been a decade ago. Me and my current boss maintain each others code all the time and it’s rare that either of us had to ask the other “wtf are you doing here”. We’re both pretty good coders though even if I do say so myself.
Edit: We’re both also mostly writing medium sized web apps and the backend services to support them. Not mission control launch programs.
Depends on the scope of the projects I think. I lead a project to build my company’s data warehouse and analytics/reporting platforms years ago as an outside consultant. We did a ton of documentation on the data movement side and definitions/structures for the target platforms. When I got back I found that there had been a lot of changes, many of which didn’t make sense, and the only documentation behind those changes was a bunch of poorly written tickets that didn’t tell me anything. It’s not hard for a developer to follow code, but in my case it’s more defining what they were trying to accomplish with the code that’s the missing piece. So why did they write the data movement process the way they did and what requirements is it meeting with the data it’s fetching.
The developer who was doing most of the work was an idiot and his boss managed big billing applications and had no experience with this type of application. As a result we have spent the last couple years fixing shit rather than moving forward with new development projects. I have been pushing their new boss to implement documentation requirements and reviews as part of the development process as it avoids mistakes (the current developer has had to redo a bunch of work too) along with independent QA.
I think it’s useful to work through the process as it provides better output and also is necessary for business continuity because the only person in the company with a deep knowledge of that system is me. If I leave they are fucked because nobody there knows how to architect shit, what the output is supposed to be or why it was built the way it was. They could bring in consultants from the outside to help out, but they have nothing to work from other than the original documentation that’s outdated. It’s all custom work moving data into a custom structure based on rules taking data from highly customized source applications. With the state it’s in they could end up starting from scratch if they had to start over with a new team.
-
@gustaf said in The OFFICIAL programming thread:
@hog said in The OFFICIAL programming thread:
I can’t remember the last time I was asked write documentation. Must have been a decade ago. Me and my current boss maintain each others code all the time and it’s rare that either of us had to ask the other “wtf are you doing here”. We’re both pretty good coders though even if I do say so myself.
Edit: We’re both also mostly writing medium sized web apps and the backend services to support them. Not mission control launch programs.
What kind of web apps?
Have you heard of pornhub.com?
