John Jetmore dijo [Wed, Dec 19, 2007 at 11:04:05AM -0500]: > > I appreciate the offer. I've been rewriting the documentation from > scratch (mostly). I've been adding to the same basic documentation > since 2001 with no care given to how much the functionality has > grown. It's gotten clunky and I've actually received some > complaints about it. Some goals from the rewrite: > > -) instead of a large group of all options, split docs into logical > sections and explain any details needed for that section and > provide arguments all together. > > -) provided a "quick start" as soon as possible to give people an > idea of what swaks is about and to whet their appetite for sosme of > the things it can do. > > -) as I rewrite the docs, have the docs state what I think swaks > should do and then confirm or implement the desired behaviour > (instead of the other way around). > > With that in mind, here's the first whack at my rewrite: > http://www.jetmore.org/john/code/swaks-docs-20071219.html > > For comparison, here's the last release version of the docs: > http://www.jetmore.org/john/code/swaks-docs-20070921.html > > Would you consider reviewing it and providing feedback? In addition > to general comments I would love to hear any "killer" idea for an > entry into the quick start section. The parts of the docs that I > either need to implement or confirm are in bold, it's just there > temporarily. > > FWIW I'd welcome feed back from anyone who sees this ticket and cares.
Hi, Just so this does not disappear in the mist: I'm just going out on a family vacation. I'll be back online in +- a week, and will take a look at your work. Thanks a lot! -- Gunnar Wolf - [EMAIL PROTECTED] - (+52-55)5623-0154 / 1451-2244 PGP key 1024D/8BB527AF 2001-10-23 Fingerprint: 0C79 D2D1 2C4E 9CE4 5973 F800 D80E F35A 8BB5 27AF -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
