Why oh why do so many programmers think that the coding is more important than the documentation? If you don’t write so much as a readme, how is anyone going to figure out how to use your wonderful smart clever bug ridden code?????
Eh?
A quick and completely off topic rant
Home Ed Inspiration, Ideas, and Activities
Click the links below and scroll through my collection of ideas, workshops, excursions, and more to discover practical everyday activities you can do together in and around your home classroom.
Comments
11 responses to “A quick and completely off topic rant”
–help
oops, you’re on Windows, so that’d be:
/?
oops, you’re on Windows, so that’d be:
oops, you’re on Windows, so that’d require them writing a separate Help file
(Ah, comment three should’ve been: <F1>)
At least the comment count is up :^)
What’s the app?
Good morning Jonathan.
I’m using mambo to reconstruct a website, and it has a number of plug in modules, included moshost for managing accounts and billing (at least, I think it should, if it worked…)
The drawback with open source software appears to be that it is mainly coded by hobby programmers who don’t understand the concepts of testing or documentation. My final rant last night ran along the lines that they couldn’t earn a living at it if every pro programmer dropped dead tomorrow…or something to that effect.
How can you say such a thing? http://mamboserver.com/cat/Documentation/ is beautiful. Auto-generated from the source and light on actual, useful content I’ll grant you, but it _looks_ good!
Actually, I’ll retract that last comment:
http://mamboforge.net/cgi-bin/cvsweb.cgi/*checkout*/mambo/4.5_manuals/english/dev/MamboDevelopment.pdf?rev=1.3&content-type=application/pdf
Yes, I’ve read the pdf. I still don’t know how to actually set up a site. I like my instructions in the step by step, 1 page list format, not the incompehensible, aren’t we clever, top heavy pdf variety. I don’t want to code the blasted application (well, not right now, anyway 😉 ) I want to use it! But they don’t seem to be very open to ppl doing that. Odd.
And mosHost (or mamboHost, depending on who you ask) doesn’t appear to have any documentation.