The Art of programming

mrjj

Having a bit of Friday fun about the big DD ;)
(DD = Design and Documentation)

JonB

@jsulm
OMG, near-religious profundity in this forum... ;-)

jsulm

@JonB This is not religion this is a fact! :-)

J.Hilk

alt text

Even the most complex program, starts with the first line of code

mrjj

@J-Hilk
Actually, when you are not a beginner anymore
A complex program starts with design and specifications. :)
Or at least it often should :)

jsulm

@mrjj said in How to enter Images in a listWidget inside tabWidget:

A complex program starts with design and specifications. :)

In which universe? :-)

mrjj

@jsulm
haha :)
well in same universe
where all write module test and documentation
at the same time as the main code.
Sort of like a Land of Narnia for adults ;)

J.Hilk

@mrjj
😨 fine 🙄

But let's be honest, everything starts with int as in int main()

SGaist

@J-Hilk said in How to enter Images in a listWidget inside tabWidget:

@mrjj
😨 fine 🙄

But let's be honest, everything starts with int as in int main()

Unless you use Python :-P

JonB

@mrjj
"design", "specification", "testing", "documentation". Are these from a computer science course? Next you'll be saying we should use "comments". I don't think they are intended for Real Programmers....

mrjj

@JonB

Heh :)
Im not really sure they do include it as they seem to only tell about main.cpp and
nothing else exists :)

If you must use comments, make sure it simply repeats what the code said

// make new object
Object *obj = new Object;

and not that intent of it

// prepare account object for insertion to database

Else its far too easy to the maintenance crew.

Also do not alter the comments if you change the code. :)

JonB

@mrjj said in How to enter Images in a listWidget inside tabWidget:

If you must use comments, make sure it simply repeats what the code said

Absolutely spot-on with this! And not just comments, it drives me mad that often that actual end-user documentation/Help for the FooBar button says "Does a FooBar". Gee, I would never have guessed without that! But what does that actually do? Will it reformat my disk?

mrjj

@JonB
ahah exactly. :)

Like sitting with a very expensive raid controller and
have the field that says
Idle time for GX44 interrupt core.
and the docs says

"Allows you to change the value"

No shit sherlock..

ps. maybe we should fork the thread :)

J.Hilk

@SGaist I bet ya, the python interpreter starts with int main( 😎

@mrjj

ps. maybe we should fork the thread :)

probably a good idea, we derailed quite a lot

mrjj

@J-Hilk
No as derailed as my first attempt to move it :)))

J.Hilk

@mrjj I noticed!

It even went 10 years to the past 🤣

fcarney

This is how my designs usually go:

Customer: We want to do "this"
Me: What do you want "this" to look like?
Customer: I don't know
Me: <creates interface and basic functionality>
Me: How about "this"?
Customer: Well we don't want "that"! Here is what we want...
Me: <thinking>Why didn't they say that before?

So for anything I build that sequence events is usually how every project starts. Rarely do I get specs at all. Even from my management who programs. They usually say "this" with no real details.

aha_1980

Hi @fcarney,

Me: <creates interface and basic functionality>

Don't you have a bot for that? ;)

Regards

JonB

@fcarney
So true! At least I know I am not alone....

One step worse: your example implies when they see it they say "we didn't want it done (looking) that way, we wanted it done this way". But I often get: "we don't want that at all, we want it to do something totally different from what we said we wanted it to do". :(

fcarney

That happens sometimes too.