Live data from Hacker News

Narbacular Drop Technical Design Document [pdf]

nuclearmonkeysoftware.com

11–18 of 18 posts

Re: Narbacular Drop Technical Design Document [pdf]

#11
post #8

Nice piece of history, and hilariously/sweetly innocent/naive in its specificity and certainty, like only newbies' first "design document" could be.

I have issues with this 'longform word doc' format of design documentation in general. It's tedious, no-one bothers to do more than skim read it, it conveys method but not intentions, etc.

Re: Narbacular Drop Technical Design Document [pdf]

#13
Coding guidelines

- Precompute whenever even remotely possible.

- Measures must be taken to prevent copy paste errors.

- Measures must be taken to prevent copy paste errors.

- The STL is evil (most of the time).

- Unnecessarily virtual functions should be rewritten to remove virtual requirements.

- Sloppy code must be marked for recoding later.

- Unreadable code earns you a free punch in the face.

- Measures must be taken to prevent copy paste errors.

Re: Narbacular Drop Technical Design Document [pdf]

#14
post #8

Nice piece of history, and hilariously/sweetly innocent/naive in its specificity and certainty, like only newbies' first "design document" could be.

I have issues with this 'longform word doc' format of design documentation in general. It's tedious, no-one bothers to do more than skim read it, it conveys method but not intentions, etc.

I assume this was a class assignment or project, wasn't it? The format was probably dictated by DigiPen instructors.

Re: Narbacular Drop Technical Design Document [pdf]

#16

Earlier quoted context omitted.

I have issues with this 'longform word doc' format of design documentation in general. It's tedious, no-one bothers to do more than skim read it, it conveys method but not intentions, etc.

I assume this was a class assignment or project, wasn't it? The format was probably dictated by DigiPen instructors.

Yeah. I'm not sure if Digipen still teaches it but I know others do, unfortunately.

Re: Narbacular Drop Technical Design Document [pdf]

#18

Coding guidelines - Precompute whenever even remotely possible. - Measures must be taken to prevent copy paste errors. - Measures must be taken to prevent copy paste errors. - The STL is evil (most of the time). - Unnecessarily virtual functions should be rewritten to remove virtual requirements. - Sloppy code must be marked for recoding later. - Unreadable code earns you a free punch in the face. - Measures must be…

"Checkouts can be performed at will (network permitting), but all code checked into the primary code branch MUST compile. Anyone caught checking-in uncompilable code will be tarred and feathered."
Post reply on HN