Click here to Skip to main content
15,918,617 members

Welcome to the Lounge

   

For discussing anything related to a software developer's life but is not for programming questions. Got a programming question?

The Lounge is rated Safe For Work. If you're about to post something inappropriate for a shared office environment, then don't post it. No ads, no abuse, and no programming questions. Trolling, (political, climate, religious or whatever) will result in your account being removed.

 
GeneralRe: Silly Documentation Question Pin
Mike Hankey16-Apr-24 7:29
mveMike Hankey16-Apr-24 7:29 
GeneralRe: Silly Documentation Question Pin
Gary Wheeler17-Apr-24 1:02
Gary Wheeler17-Apr-24 1:02 
GeneralRe: Silly Documentation Question Pin
Mike Hankey17-Apr-24 1:24
mveMike Hankey17-Apr-24 1:24 
GeneralRe: Silly Documentation Question Pin
Gary Wheeler17-Apr-24 1:33
Gary Wheeler17-Apr-24 1:33 
GeneralRe: Silly Documentation Question Pin
Mike Hankey17-Apr-24 1:37
mveMike Hankey17-Apr-24 1:37 
GeneralRe: Silly Documentation Question Pin
trønderen17-Apr-24 6:43
trønderen17-Apr-24 6:43 
GeneralRe: Silly Documentation Question Pin
Mike Hankey17-Apr-24 6:47
mveMike Hankey17-Apr-24 6:47 
GeneralRe: Silly Documentation Question Pin
trønderen17-Apr-24 8:51
trønderen17-Apr-24 8:51 
There are people/companies promoting 'Test Driven Development', writing all the tests, from module level and upwards, before any coding is started. I have even talked with people claiming to practice it Smile | :)

For all my private projects, I practice 'Documentation Driven Development': I write both (end) User Guide and system documentation (implementation language independent, as noted earlier) before I start coding. Admittedly, it happens that the 'ideal' view of the system, described in the documentation, cannot be realized 100% in practice. Yet I would say that having the 'ideal' solution in the documentation is a great help to make sure that adaptations are done in a structured and architecturally sound ways, so that they do not appear as random hacks. Both end user and system documentation is of course updated correspondingly.

The one big software suite I was working on that tried to follow a TDD style (admittedly, tests were implemented in parallel with the code, but by a completely independent team) did experience very similar situations: The original spec, underlaying both tests and code, could not reasonably be implemented exactly as given, so both code and tests had to be modified midway. Specs are not carved in stone.

Religious freedom is the freedom to say that two plus two make five.

GeneralRe: Silly Documentation Question Pin
Mike Hankey17-Apr-24 9:18
mveMike Hankey17-Apr-24 9:18 
GeneralRe: Silly Documentation Question Pin
charlieg18-Apr-24 17:05
charlieg18-Apr-24 17:05 
GeneralRe: Silly Documentation Question Pin
charlieg18-Apr-24 17:26
charlieg18-Apr-24 17:26 
GeneralRe: Silly Documentation Question Pin
rob tillaart16-Apr-24 20:50
rob tillaart16-Apr-24 20:50 
GeneralRe: Silly Documentation Question Pin
glennPattonWork316-Apr-24 21:54
professionalglennPattonWork316-Apr-24 21:54 
GeneralRe: Silly Documentation Question Pin
Nelson Goncalves Oct202217-Apr-24 2:17
Nelson Goncalves Oct202217-Apr-24 2:17 
GeneralRe: Silly Documentation Question Pin
jochance18-Apr-24 5:58
jochance18-Apr-24 5:58 
GeneralRe: Silly Documentation Question Pin
charlieg18-Apr-24 17:17
charlieg18-Apr-24 17:17 
GeneralWhat sort of performance should I expect? Pin
dandy7216-Apr-24 5:03
dandy7216-Apr-24 5:03 
GeneralRe: What sort of performance should I expect? Pin
PIEBALDconsult16-Apr-24 5:35
mvePIEBALDconsult16-Apr-24 5:35 
GeneralRe: What sort of performance should I expect? Pin
dandy7216-Apr-24 5:46
dandy7216-Apr-24 5:46 
GeneralRe: What sort of performance should I expect? Pin
jochance17-Apr-24 8:01
jochance17-Apr-24 8:01 
GeneralRe: What sort of performance should I expect? Pin
k505416-Apr-24 6:04
mvek505416-Apr-24 6:04 
GeneralRe: What sort of performance should I expect? Pin
dandy7216-Apr-24 7:00
dandy7216-Apr-24 7:00 
GeneralRe: What sort of performance should I expect? Pin
k505416-Apr-24 7:10
mvek505416-Apr-24 7:10 
GeneralRe: What sort of performance should I expect? Pin
dandy7216-Apr-24 7:37
dandy7216-Apr-24 7:37 
GeneralRe: What sort of performance should I expect? Pin
theoldfool16-Apr-24 6:54
professionaltheoldfool16-Apr-24 6:54 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.