|
Would it be an alternative to switch to DDD - Documentation Driven Development, a sibling of TDD, Test Driven Development, but even before you write the tests, which by TDD is before you write the code, you write the Documentation!
Once you have documented all the externally visible method signatures (as well as the implementation architecture, data structures etc.) and then written tests bases on these, then the need for declaring a compileable interface definition is significantly reduced. It won't take you any more resources to start out with the documentation, instead of delaying it until the coding is complete. Quite to the contrary: Good documentation may help speed up coding, when you know where everything fits into The Big Picture. (I take for granted that you do write proper documentation of the system you create.)
(And then I will return to doing the last checks of the documentation of my new hobby project, so that I may start coding it tomorrow.)
|
|
|
|
|
Documentation is good to have before implementing the feature. Having everything spelled out beforehand is useful for the product owner, tester, and developer. It gives a contract of what to expect. I did this once at a company I worked for. The product owner gave us a set of requirements for a feature. We, the developers would flesh it out into a specification, including the UI, how the UI worked (buttons, sliders, inputs, screen layout, tabs, etc.), underlying algorithms, workflows (user input, processing, output, formatting), file storage formats, etc. This would be kept and later, parts would become user documents, functional documents, and technical documents.
The downside to this is that in future releases, when we needed to change the features, these documents would need updating. Usually, more work than we we first created them.
|
|
|
|
|
In the late 1960s, a Norwegian research institute build a prototype for a 16-bit mini - "mini" in those days meaning a full height 19" rack. Around 1971, one grand old company was going to commercialize this design. As always, they had all the documentation printed (500 copies) before the real production was started.
Then it was discovered that the guys doing the documentation had been making a couple of errors: For the shift instructions, they had mixed up the bit selecting rotational shift with the don't care bit. And the description of address calculation where the base register (i.e. stack frame pointer) was involved was incorrect. But the documentation was already made, the machines were not. So rather than having to revise 500 copies of documentation, they decided to rather build the machine to behave the way the documentation described it.
This is even more crazy considering that two companies were invited to commercialize the design. The other company (a small startup company where they hardly knew the meaning of the word 'documentation') copied the prototype design. So there you had two Norwegian-built machines, with identical instruction set except for rotational shift and identical addressing mechanisms except for stack relative addressing.
Both machine series survived for quite a few years, but I never saw a single piece of software that was made to run on both machines. No common compiler with a switch to select either the "KV" or "ND" CPU variant. They ended up in completely non-overlapping market segments, rather than the intention of establishing a solid Norwegian computer industry with two manufacturers sharing architecture and design resources. Thanks to a tech writer who didn't understand the things he was documenting.
|
|
|
|
|
The big problem is that the interface seems to NEVER live in the correct place. The interface should be either in the project of the consumer (for true Inversion of Control), or a shared project such that it could be consumed by multiple front ends.
All too often a class is written than interface is abstracted which is to say the horse is pushing the cart.
|
|
|
|
|
|
OriginalGriff wrote: they took their time doing it though
They'll claim "incubation period", I'm sure.
Software rusts. Simon Stephenson, ca 1994. So does this signature. me, 2012
|
|
|
|
|
David Icke?
That explains a lot.
I met that pr1ck when he was trying to build a career as a TV "personality". A little self-obsession is normal, in the entertainments field, but this guy genuinely believed that the world revolved around him and the Sun shone out of his @rse (so even then he had zero grasp on science).
He quit his TV endeavours because he was too good for TV (he arrived at that conclusion about a year after everyone stopped hiring him because of his combination of being both useless at the job and unbearable to work with), and started on the conspiracy theory trail, which is the best way for incompetent bullsh1tters to pick up mentally deranged worshippers.
He's the kind of self-absorbed, "truth is less important than I am" w@nker who makes the world worse no matter what he does, because everything he does is to get attention for himself, and he doesn't care who gets hurt in the process.
I do hope that the police are looking into conspiracy to commit criminal damage charges.
I wanna be a eunuchs developer! Pass me a bread knife!
|
|
|
|
|
Mark_Wallace wrote: He's the kind of self-absorbed, "truth is less important than I am" w@nker who makes the world worse no matter what he does, because everything he does is to get attention for himself, and he doesn't care who gets hurt in the process.
There are many more people of this kind than we actually need, and some of them can really do / are doing a lot of damage.
Mark_Wallace wrote: I do hope that the police are looking into conspiracy to commit criminal damage charges.
It would be a good start. But I still doubt that the ones that should be in the accusation sits ever see the inner side of a court. 
M.D.V. 
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
Not a fan then! 
|
|
|
|
|
Oh, you're just guessing, now.
I wanna be a eunuchs developer! Pass me a bread knife!
|
|
|
|
|
Don't worry, you'll still be able to find it on FB.
|
|
|
|
|
David Icke's like can make a conspiracy theory even for atoms... like the rich are collecting atoms as part of a global conspiracy and we will soon run out of atoms....
Caveat Emptor.
"Progress doesn't come from early risers – progress is made by lazy men looking for easier ways to do things." Lazarus Long
|
|
|
|
|
abmv wrote: the rich are collecting atoms as part of a global conspiracy and we will soon run out of atoms
I didn't know that. Quick - tell your friends. Must rush off to get some atom before they all go.
|
|
|
|
|
During the cold war, there were anti-nuclear-weapons movements demanding "atom free zones". One thing: Those zones would be rather empty places.
|
|
|
|
|
Member 7989122 wrote: anti-nuclear-weapons movements demanding "atom free zones"
Nice, I wasn't aware of that one.
Personally, I like the bumper sticker from the greenies, presenting nukes (as in power plants, not weapons) as evil and clamoring for solar panels instead. I guess nobody explained to them the sun is the biggest nuclear power plant in the entire solar system.
Or those who want everything to be "chemicals-free".
|
|
|
|
|
You're way slow off the mark. I've already got several roomsful.
I wanna be a eunuchs developer! Pass me a bread knife!
|
|
|
|
|
I've seem a lot more "conspiracy" theories on Facebook aimed at people, not technology. Former and current presidents of the US, one political party or the other, one congressman/woman or the other, or a nation. But, not yet technology. The only way 5G networks could cause this problem is because of it faster speed compared to 4G, which allowed the maker of the virus better communications to get to market quicker?
|
|
|
|
|
|
Speaking of which, some stats...
Glad to see that, if the stat were to be believed, Australia is doing so well!
Australia Coronavirus: 5,988 Cases and 49 Deaths - Worldometer
France Coronavirus: 109,069 Cases and 10,328 Deaths - Worldometer
New Zealand Coronavirus: 1,210 Cases and 1 Deaths - Worldometer
United States Coronavirus: 400,489 Cases and 12,857 Deaths - Worldometer
United Kingdom Coronavirus: 55,242 Cases and 6,159 Deaths - Worldometer
|
|
|
|
|
Damn it! I thought he might pull through... 
'Angel from Montgomery Maywood', a town a few miles south of where I call home.
"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
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
Yeah I thought he would too!
It's a sad day, I been listening to him since 75 and he never ceased to amaze me.
I did get to see him in concert at a smallish venue 6 years ago or so.
I'm hiding from exercise...I'm in the fitness protection program.
JaxCoder.com
|
|
|
|
|
I've seen him a couple of times over last few years, and he never failed to deliver, in a very down to earth, wonderful kind of way.
"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
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
Yep
2 hour tribute PRX[^]
I'm hiding from exercise...I'm in the fitness protection program.
JaxCoder.com
|
|
|
|
|
Thanks.
"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
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
It was an emotional wedding - even the cake was in tiers.
"I have no idea what I did, but I'm taking full credit for it." - ThisOldTony
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
