posted Friday, January 03, 2003 at 1:04 am MST
Scott Amberl's online writings, The Agile Edge at SDS, and on UML
A good example of a documents set is this bugzilla directory at linux-dsi, the Linux Documentation project. (Or, again at CS Knoxville, another project doc_set, again an open a directory. There's an !INDEX here.)
!-- and my blogger just threw a 513 ... again, template blown away?!!
"Procrastination. Hard work often pays off after time, but laziness always pays off now.
Delusions. There is no greater joy than soaring high on the waves of your dreams, except maybe the joy of watching a dreamer who has nowhere to land but in the ocean of reality.
Consulting. If you're not part of the solution, there's good money to be made in prolonging the problem."
posted Wednesday, January 01, 2003 at 9:50 am MST
*Aspirin, anyone??*New Year's Day shouts (not too loud, please) out to:
- David I., who knows SMART from dumb, and "rise from "dawn". *grin*
- (with aulde lang syne) to David Sable, who workshopped me into tech_doc think
- jwz, who knows navel gazing when he suffers its consequences
- to Ward and all the change junkies at Portland Pattern Wiki (or, if you'd rather: PortlandPatternRepository)
- Lars Marius Garshol, all the other ontopians out there, and all the netizens, CMC types, and IT nerds who are beetling away at W3C, OASIS IETF, and FSF.
- Pieter Hintjens (who knows that a beer cap is a pressure release valve when you're a white boy broken down on the side of a desert road) and the kidz at Imatix (a beautiful site redesign; but where'd our motto go to?!), for having brought us ... for my money (Open Source rulez!), the slickest server yet!
- Pieter! How about doing a Libero blog?! *grin*
- Douglas Adams, who teaches me gentle compassion for in-duh-viduals
- Jay Fenello and other folk who are pulling together to keep the net and the world free, as in free
- the many good spirits and souls at NewCivNet; thanks so much, Flemming.
- and lastly, for all the good lads and lasses past and present connected with Mozilla, a golden oldie:
When all you've got is a railgun, everything looks like a train.
"A system must have an aim. Without an aim, there is no system. ... A system must be managed. ... The secret is cooperation between components toward the aim of the organization."
--W. Edwards Deming, The New Economics
quoted by Howard Smith and Peter Fingar
in Business Process Management: The Third Wave)
"That's what makes you special, Jamie."
"Stacking a thousand doghouses one atop the other to build a skyscraper is a great proposition for doghouse vendors, but not for future occupants. Skyscrapers need an architecture of their own- their own paradigm"
-- Howard Smith and Peter Fingar
in Business Process Management: The Third Wave
Well, as gentle as possible.
"...that as we enjoy great advantages from the inventions of others, we should be glad of an opportunity to serve others by an invention of ours, and this we should do freely and generously..."And, dedicated to the Redmond^Borg:
-- Benjamin Franklin
"To be radical, empiricism must neither admit into its constructions any element that is not directly experienced, nor exclude from them any element that is."
-- William James
?Always tell only the truth, and all the truth, and do so promptly ? right now.?
-- Buckminster Fuller
Democracy is based upon the conviction that there are extraordinary possibilities in ordinary people.
-- Harry Emerson Fosdick "Bad ideas flourish because they are in the interest of powerful groups."
-- Paul Krugman
from original site as one big slab of really ugly HTML (I'd never write gack like this by hand)
Yaaaa I know blink sux ... it's just for the day ... 1JAN03
Topic Map links collected by Lars Marius Garshol
Friday, December 13, 2002:
Dang!! ... blogger.com lost its templates at some time, so all of this site's customization is now *pffffft* history. Well, dang!!
*Thud!!* ... according to Martin Fowler's essay on technical documents, that's the sound of doom ... and I agree, totally.
If I want to find out Bluebeard's age at the time of his execution, I /don't/ want to haul an encyclopedia off the shelf, and there's no reason I should have to. But "communication" is too often measured by the gross presence of /wey too much/ ... and I don't think things are better just because the pages are virtual rather than pulp and ink.
You know, we're very very good at doing what we do, when we know what we're doing. And when we're not doing well, I suspect it's because we don't know what we're on about.
Something I picked up just today:
"Stacking a thousand doghouses one atop the other to build a skyscraper is a great proposition for doghouse vendors, but not for future occupants. Skyscrapers need an architecture of their own - their own paradigm"
Howard Smith and Peter Fingar; Business Process Management: The Third Wave
Bernard // 18:54
Sunday, November 17, 2002:
Bernard // 21:05
Friday, November 15, 2002
Indymedia . Test . BenTrem
I'm trying to find evidence of e-mail address spoofing in this:
posted by Bernard Tremblay 11:48 PM
Saturday, November 09, 2002
posted by Bernard Tremblay 12:00 PM
Wednesday, July 17, 2002:
Here are search results: google NGs for ''documentation''. Know what? I'm tempted to say that the stuff this turned up is a lot more interesting than the stuff that was being chatted about years ago ... but I'm not actually certain that's true. Actually, I think it's basically the same. Get it? Get it?!! Point: year after year we've been re-inventing the wheel, and with good reason: the f'n wheel ain't round, or it's round and mooshy, or round and too hard, or it falls off and breaks when it turns ... Geeeeeesh, we're still not producing good docs systematically? Seems like a case of passive-aggression to me. (It's really simpler than that ... old fashion corruption: "Get the damned thing shipped out Friday, and the devil take the hind-most.")
Bernard // 08:01
Saturday, July 13, 2002:
Martin Fowler on tech_docs: The Almighty Thud. (I cud'n'uh sed it better myself)
Bernard // 19:29
Thursday, July 04, 2002:
Various Doc Docs & Resources
- Moz Zope
- Mozilla Developer Documentation
- Writer's FAQ
- Development: Documentation
- mozilla.org Style Guide
- documentation tools and templates
- contribute documentation
- "mozilla documentation project"
Bernard // 19:12
Wednesday, July 03, 2002:
(New Start on Docs)
* At zope.org:
* At zope.org:Document Engineering, Character Encoding Issues, and Document Namespace Issues. Udell's archive: Tangled in Threads
* At M$ *Gack Ptui!*: Reinventing the Online Help in XML
* How NonProgrammers Use Documentation at advogato
* Free Software and Free Manuals from FSF
Bernard // 21:04
Wednesday, March 13, 2002:
* Not only does MicroGold seem to have an awesome IDE for UML, but their site also hosts a really impressive set of tutorials on UML with C and Java
Bernard // 09:22