[Date Prev][Date Next] [Chronological] [Thread] [Top]

Re: Documentation

Quanah Gibson-Mount wrote:

--On Wednesday, March 14, 2007 9:05 AM -0400 louis gonzales <gonzales@linuxlouis.net> wrote:

I'm going to have to disagree with that statement.

You are obviously welcome to disagree. I will note, however, that I periodically browse the how-to's returned by google, and contact (or attempt to at least) the authors to get them to take them down or update them. So I have a rather good idea of what is out there. And the majority of it is not correct(*Incorrect relative to what? If the doc captured a successful deploy for the variables involved with the person deploying, than it is obviously _correct_ to them, or?*), or at least not correct in relation to the current release series (2.3)(*If someone chooses to use a document outlining a deploy of 1.x.y.z for a 2.3 software bundle, then that's their problem and they'll discover that soon enough)*. And I've seen them cause endless confusion(*re-enforces my point, about relativity, for whom does it cause this? To the person deploye 1.xxy on 2.3, sure, sounds like they're already confused :) *), both on the list and the #ldap channel on freenode. I'm glad you had a good experience, but you are the exception, rather than the rule (unfortunately)(*Not an exception by any means, just not confused :D )*.

I think the take away from this should be:
- Do the due proper pre-deployment research
- Understand at least what versions one is attempting to deploy - based on features necessary to meet deployment objective
- Docs on the internet (good/bad/accurate/inaccurate) need to be thought through and aligned with 1st bullet
- Docs on the internet provide good referential/supplemental material (good practice is to ensure versions outlined in docs, apply to your scenario)
- Statement about "bad and incorrect" documents is certainly true to the extent that they exist ( my point IS that both lend insight into the correct path, namely getting successful deployment )
-- No two deployments will _ever_ be identical 100% - there will always be variables when dealing with software (while humankind has created many marvels, we still have the problem of proving 100% perfection in logic)



-- Quanah Gibson-Mount Principal Software Developer ITS/Shared Application Services Stanford University GnuPG Public Key: http://www.stanford.edu/~quanah/pgp.html

-- Email: louis.gonzales@linuxlouis.net WebSite: http://www.linuxlouis.net "Open the pod bay doors HAL!" -2001: A Space Odyssey "Good morning starshine, the Earth says hello." -Willy Wonka